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

letta_client/folders/agents/client.py

@@ -0,0 +1,176 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.request_options import RequestOptions
+from .raw_client import AsyncRawAgentsClient, RawAgentsClient
+from .types.agents_list_request_order import AgentsListRequestOrder
+
+
+class AgentsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawAgentsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawAgentsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawAgentsClient
+        """
+        return self._raw_client
+
+    def list(
+        self,
+        folder_id: str,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[AgentsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[str]:
+        """
+        Get all agent IDs that have the specified folder attached.
+
+        Parameters
+        ----------
+        folder_id : str
+
+        before : typing.Optional[str]
+            Agent ID cursor for pagination. Returns agents that come before this agent ID in the specified sort order
+
+        after : typing.Optional[str]
+            Agent ID cursor for pagination. Returns agents that come after this agent ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of agents to return
+
+        order : typing.Optional[AgentsListRequestOrder]
+            Sort order for agents by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[str]
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+        client.folders.agents.list(
+            folder_id="folder_id",
+        )
+        """
+        _response = self._raw_client.list(
+            folder_id,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            request_options=request_options,
+        )
+        return _response.data
+
+
+class AsyncAgentsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawAgentsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawAgentsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawAgentsClient
+        """
+        return self._raw_client
+
+    async def list(
+        self,
+        folder_id: str,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[AgentsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[str]:
+        """
+        Get all agent IDs that have the specified folder attached.
+
+        Parameters
+        ----------
+        folder_id : str
+
+        before : typing.Optional[str]
+            Agent ID cursor for pagination. Returns agents that come before this agent ID in the specified sort order
+
+        after : typing.Optional[str]
+            Agent ID cursor for pagination. Returns agents that come after this agent ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of agents to return
+
+        order : typing.Optional[AgentsListRequestOrder]
+            Sort order for agents by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[str]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.folders.agents.list(
+                folder_id="folder_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list(
+            folder_id,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            request_options=request_options,
+        )
+        return _response.data

letta_client/folders/agents/raw_client.py

@@ -0,0 +1,182 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ...core.api_error import ApiError
+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.http_response import AsyncHttpResponse, HttpResponse
+from ...core.jsonable_encoder import jsonable_encoder
+from ...core.request_options import RequestOptions
+from ...core.unchecked_base_model import construct_type
+from ...errors.unprocessable_entity_error import UnprocessableEntityError
+from ...types.http_validation_error import HttpValidationError
+from .types.agents_list_request_order import AgentsListRequestOrder
+
+
+class RawAgentsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list(
+        self,
+        folder_id: str,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[AgentsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[typing.List[str]]:
+        """
+        Get all agent IDs that have the specified folder attached.
+
+        Parameters
+        ----------
+        folder_id : str
+
+        before : typing.Optional[str]
+            Agent ID cursor for pagination. Returns agents that come before this agent ID in the specified sort order
+
+        after : typing.Optional[str]
+            Agent ID cursor for pagination. Returns agents that come after this agent ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of agents to return
+
+        order : typing.Optional[AgentsListRequestOrder]
+            Sort order for agents by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[typing.List[str]]
+            Successful Response
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/folders/{jsonable_encoder(folder_id)}/agents",
+            method="GET",
+            params={
+                "before": before,
+                "after": after,
+                "limit": limit,
+                "order": order,
+                "order_by": order_by,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    typing.List[str],
+                    construct_type(
+                        type_=typing.List[str],  # 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)
+
+
+class AsyncRawAgentsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list(
+        self,
+        folder_id: str,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[AgentsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[typing.List[str]]:
+        """
+        Get all agent IDs that have the specified folder attached.
+
+        Parameters
+        ----------
+        folder_id : str
+
+        before : typing.Optional[str]
+            Agent ID cursor for pagination. Returns agents that come before this agent ID in the specified sort order
+
+        after : typing.Optional[str]
+            Agent ID cursor for pagination. Returns agents that come after this agent ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of agents to return
+
+        order : typing.Optional[AgentsListRequestOrder]
+            Sort order for agents by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[typing.List[str]]
+            Successful Response
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/folders/{jsonable_encoder(folder_id)}/agents",
+            method="GET",
+            params={
+                "before": before,
+                "after": after,
+                "limit": limit,
+                "order": order,
+                "order_by": order_by,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    typing.List[str],
+                    construct_type(
+                        type_=typing.List[str],  # 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)

letta_client/folders/agents/types/__init__.py

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

letta_client/folders/agents/types/agents_list_request_order.py

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

letta_client/folders/client.py

@@ -7,9 +7,11 @@ from ..core.request_options import RequestOptions
 from ..types.embedding_config import EmbeddingConfig
 from ..types.folder import Folder
 from ..types.organization_sources_stats import OrganizationSourcesStats
+from .agents.client import AgentsClient, AsyncAgentsClient
 from .files.client import AsyncFilesClient, FilesClient
 from .passages.client import AsyncPassagesClient, PassagesClient
 from .raw_client import AsyncRawFoldersClient, RawFoldersClient
+from .types.folders_list_request_order import FoldersListRequestOrder
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -20,6 +22,8 @@ class FoldersClient:
         self._raw_client = RawFoldersClient(client_wrapper=client_wrapper)
         self.files = FilesClient(client_wrapper=client_wrapper)
 
+        self.agents = AgentsClient(client_wrapper=client_wrapper)
+
         self.passages = PassagesClient(client_wrapper=client_wrapper)
 
     @property
@@ -190,7 +194,10 @@ class FoldersClient:
 
     def retrieve_by_name(self, folder_name: str, *, request_options: typing.Optional[RequestOptions] = None) -> str:
         """
-        Get a folder by name
+        **Deprecated**: Please use the list endpoint `GET /v1/folders?name=` instead.
+
+
+        Get a folder by name.
 
         Parameters
         ----------
@@ -219,7 +226,7 @@ class FoldersClient:
         _response = self._raw_client.retrieve_by_name(folder_name, request_options=request_options)
         return _response.data
 
-    def get_folders_metadata(
+    def retrieve_metadata(
         self,
         *,
         include_detailed_per_source_metadata: typing.Optional[bool] = None,
@@ -254,19 +261,47 @@ class FoldersClient:
             project="YOUR_PROJECT",
             token="YOUR_TOKEN",
         )
-        client.folders.get_folders_metadata()
+        client.folders.retrieve_metadata()
         """
-        _response = self._raw_client.get_folders_metadata(
+        _response = self._raw_client.retrieve_metadata(
             include_detailed_per_source_metadata=include_detailed_per_source_metadata, request_options=request_options
         )
         return _response.data
 
-    def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Folder]:
+    def list(
+        self,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[FoldersListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        name: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[Folder]:
         """
         List all data folders created by a user.
 
         Parameters
         ----------
+        before : typing.Optional[str]
+            Folder ID cursor for pagination. Returns folders that come before this folder ID in the specified sort order
+
+        after : typing.Optional[str]
+            Folder ID cursor for pagination. Returns folders that come after this folder ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of folders to return
+
+        order : typing.Optional[FoldersListRequestOrder]
+            Sort order for folders 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]
+            Folder name to filter by
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -285,7 +320,15 @@ class FoldersClient:
         )
         client.folders.list()
         """
-        _response = self._raw_client.list(request_options=request_options)
+        _response = self._raw_client.list(
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            name=name,
+            request_options=request_options,
+        )
         return _response.data
 
     def create(
@@ -358,45 +401,14 @@ class FoldersClient:
         )
         return _response.data
 
-    def get_agents_for_folder(
-        self, folder_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.List[str]:
-        """
-        Get all agent IDs that have the specified folder attached.
-
-        Parameters
-        ----------
-        folder_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.List[str]
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.folders.get_agents_for_folder(
-            folder_id="folder_id",
-        )
-        """
-        _response = self._raw_client.get_agents_for_folder(folder_id, request_options=request_options)
-        return _response.data
-
 
 class AsyncFoldersClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
         self._raw_client = AsyncRawFoldersClient(client_wrapper=client_wrapper)
         self.files = AsyncFilesClient(client_wrapper=client_wrapper)
 
+        self.agents = AsyncAgentsClient(client_wrapper=client_wrapper)
+
         self.passages = AsyncPassagesClient(client_wrapper=client_wrapper)
 
     @property
@@ -601,7 +613,10 @@ class AsyncFoldersClient:
         self, folder_name: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> str:
         """
-        Get a folder by name
+        **Deprecated**: Please use the list endpoint `GET /v1/folders?name=` instead.
+
+
+        Get a folder by name.
 
         Parameters
         ----------
@@ -638,7 +653,7 @@ class AsyncFoldersClient:
         _response = await self._raw_client.retrieve_by_name(folder_name, request_options=request_options)
         return _response.data
 
-    async def get_folders_metadata(
+    async def retrieve_metadata(
         self,
         *,
         include_detailed_per_source_metadata: typing.Optional[bool] = None,
@@ -678,22 +693,50 @@ class AsyncFoldersClient:
 
 
         async def main() -> None:
-            await client.folders.get_folders_metadata()
+            await client.folders.retrieve_metadata()
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.get_folders_metadata(
+        _response = await self._raw_client.retrieve_metadata(
             include_detailed_per_source_metadata=include_detailed_per_source_metadata, request_options=request_options
         )
         return _response.data
 
-    async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Folder]:
+    async def list(
+        self,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[FoldersListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        name: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[Folder]:
         """
         List all data folders created by a user.
 
         Parameters
         ----------
+        before : typing.Optional[str]
+            Folder ID cursor for pagination. Returns folders that come before this folder ID in the specified sort order
+
+        after : typing.Optional[str]
+            Folder ID cursor for pagination. Returns folders that come after this folder ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of folders to return
+
+        order : typing.Optional[FoldersListRequestOrder]
+            Sort order for folders 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]
+            Folder name to filter by
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -720,7 +763,15 @@ class AsyncFoldersClient:
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.list(request_options=request_options)
+        _response = await self._raw_client.list(
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            name=name,
+            request_options=request_options,
+        )
         return _response.data
 
     async def create(
@@ -800,44 +851,3 @@ class AsyncFoldersClient:
             request_options=request_options,
         )
         return _response.data
-
-    async def get_agents_for_folder(
-        self, folder_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.List[str]:
-        """
-        Get all agent IDs that have the specified folder attached.
-
-        Parameters
-        ----------
-        folder_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.List[str]
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.folders.get_agents_for_folder(
-                folder_id="folder_id",
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.get_agents_for_folder(folder_id, request_options=request_options)
-        return _response.data

letta_client/folders/files/__init__.py

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