letta-client 0.1.324__py3-none-any.whl → 1.0.0a2__py3-none-any.whl

letta_client/agents/files/raw_client.py

@@ -12,6 +12,7 @@ from ...core.unchecked_base_model import construct_type
 from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.http_validation_error import HttpValidationError
 from ...types.paginated_agent_files import PaginatedAgentFiles
+from .types.files_list_request_order import FilesListRequestOrder
 
 
 class RawFilesClient:
@@ -185,8 +186,12 @@ class RawFilesClient:
         self,
         agent_id: str,
         *,
-        cursor: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[FilesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        cursor: typing.Optional[str] = None,
         is_open: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[PaginatedAgentFiles]:
@@ -197,11 +202,23 @@ class RawFilesClient:
         ----------
         agent_id : str
 
-        cursor : typing.Optional[str]
-            Pagination cursor from previous response
+        before : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
+
+        after : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come after this file ID in the specified sort order
 
         limit : typing.Optional[int]
-            Number of items to return (1-100)
+            Maximum number of files to return
+
+        order : typing.Optional[FilesListRequestOrder]
+            Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        cursor : typing.Optional[str]
+            Pagination cursor from previous response (deprecated, use before/after)
 
         is_open : typing.Optional[bool]
             Filter by open status (true for open files, false for closed files)
@@ -218,8 +235,12 @@ class RawFilesClient:
             f"v1/agents/{jsonable_encoder(agent_id)}/files",
             method="GET",
             params={
-                "cursor": cursor,
+                "before": before,
+                "after": after,
                 "limit": limit,
+                "order": order,
+                "order_by": order_by,
+                "cursor": cursor,
                 "is_open": is_open,
             },
             request_options=request_options,
@@ -422,8 +443,12 @@ class AsyncRawFilesClient:
         self,
         agent_id: str,
         *,
-        cursor: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[FilesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        cursor: typing.Optional[str] = None,
         is_open: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[PaginatedAgentFiles]:
@@ -434,11 +459,23 @@ class AsyncRawFilesClient:
         ----------
         agent_id : str
 
-        cursor : typing.Optional[str]
-            Pagination cursor from previous response
+        before : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
+
+        after : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come after this file ID in the specified sort order
 
         limit : typing.Optional[int]
-            Number of items to return (1-100)
+            Maximum number of files to return
+
+        order : typing.Optional[FilesListRequestOrder]
+            Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        cursor : typing.Optional[str]
+            Pagination cursor from previous response (deprecated, use before/after)
 
         is_open : typing.Optional[bool]
             Filter by open status (true for open files, false for closed files)
@@ -455,8 +492,12 @@ class AsyncRawFilesClient:
             f"v1/agents/{jsonable_encoder(agent_id)}/files",
             method="GET",
             params={
-                "cursor": cursor,
+                "before": before,
+                "after": after,
                 "limit": limit,
+                "order": order,
+                "order_by": order_by,
+                "cursor": cursor,
                 "is_open": is_open,
             },
             request_options=request_options,

letta_client/agents/files/types/__init__.py

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

letta_client/{types/tool_return_status.py → agents/files/types/files_list_request_order.py}

@@ -2,4 +2,4 @@
 
 import typing
 
-ToolReturnStatus = typing.Union[typing.Literal["success", "error"], typing.Any]
+FilesListRequestOrder = typing.Union[typing.Literal["asc", "desc"], typing.Any]

letta_client/agents/folders/__init__.py

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

letta_client/agents/folders/client.py

@@ -7,6 +7,7 @@ from ...core.request_options import RequestOptions
 from ...types.agent_state import AgentState
 from ...types.source import Source
 from .raw_client import AsyncRawFoldersClient, RawFoldersClient
+from .types.folders_list_request_order import FoldersListRequestOrder
 
 
 class FoldersClient:
@@ -96,7 +97,17 @@ class FoldersClient:
         _response = self._raw_client.detach(agent_id, folder_id, request_options=request_options)
         return _response.data
 
-    def list(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Source]:
+    def list(
+        self,
+        agent_id: str,
+        *,
+        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,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[Source]:
         """
         Get the folders associated with an agent.
 
@@ -104,6 +115,21 @@ class FoldersClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order
+
+        after : typing.Optional[str]
+            Source ID cursor for pagination. Returns sources that come after this source ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of sources to return
+
+        order : typing.Optional[FoldersListRequestOrder]
+            Sort order for sources 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.
 
@@ -122,9 +148,21 @@ class FoldersClient:
         )
         client.agents.folders.list(
             agent_id="agent_id",
+            before="before",
+            after="after",
+            limit=1,
+            order="asc",
         )
         """
-        _response = self._raw_client.list(agent_id, request_options=request_options)
+        _response = self._raw_client.list(
+            agent_id,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            request_options=request_options,
+        )
         return _response.data
 
 
@@ -232,7 +270,15 @@ class AsyncFoldersClient:
         return _response.data
 
     async def list(
-        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        agent_id: str,
+        *,
+        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,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Source]:
         """
         Get the folders associated with an agent.
@@ -241,6 +287,21 @@ class AsyncFoldersClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order
+
+        after : typing.Optional[str]
+            Source ID cursor for pagination. Returns sources that come after this source ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of sources to return
+
+        order : typing.Optional[FoldersListRequestOrder]
+            Sort order for sources 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.
 
@@ -264,10 +325,22 @@ class AsyncFoldersClient:
         async def main() -> None:
             await client.agents.folders.list(
                 agent_id="agent_id",
+                before="before",
+                after="after",
+                limit=1,
+                order="asc",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.list(agent_id, request_options=request_options)
+        _response = await self._raw_client.list(
+            agent_id,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            request_options=request_options,
+        )
         return _response.data

letta_client/agents/folders/raw_client.py

@@ -13,6 +13,7 @@ from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.agent_state import AgentState
 from ...types.http_validation_error import HttpValidationError
 from ...types.source import Source
+from .types.folders_list_request_order import FoldersListRequestOrder
 
 
 class RawFoldersClient:
@@ -122,7 +123,15 @@ class RawFoldersClient:
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
     def list(
-        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        agent_id: str,
+        *,
+        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,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[typing.List[Source]]:
         """
         Get the folders associated with an agent.
@@ -131,6 +140,21 @@ class RawFoldersClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order
+
+        after : typing.Optional[str]
+            Source ID cursor for pagination. Returns sources that come after this source ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of sources to return
+
+        order : typing.Optional[FoldersListRequestOrder]
+            Sort order for sources 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.
 
@@ -142,6 +166,13 @@ class RawFoldersClient:
         _response = self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}/folders",
             method="GET",
+            params={
+                "before": before,
+                "after": after,
+                "limit": limit,
+                "order": order,
+                "order_by": order_by,
+            },
             request_options=request_options,
         )
         try:
@@ -278,7 +309,15 @@ class AsyncRawFoldersClient:
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
     async def list(
-        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        agent_id: str,
+        *,
+        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,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[typing.List[Source]]:
         """
         Get the folders associated with an agent.
@@ -287,6 +326,21 @@ class AsyncRawFoldersClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Source ID cursor for pagination. Returns sources that come before this source ID in the specified sort order
+
+        after : typing.Optional[str]
+            Source ID cursor for pagination. Returns sources that come after this source ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of sources to return
+
+        order : typing.Optional[FoldersListRequestOrder]
+            Sort order for sources 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.
 
@@ -298,6 +352,13 @@ class AsyncRawFoldersClient:
         _response = await self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}/folders",
             method="GET",
+            params={
+                "before": before,
+                "after": after,
+                "limit": limit,
+                "order": order,
+                "order_by": order_by,
+            },
             request_options=request_options,
         )
         try:

letta_client/agents/folders/types/__init__.py

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

letta_client/agents/folders/types/folders_list_request_order.py

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

letta_client/agents/groups/__init__.py

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

letta_client/agents/groups/client.py

@@ -6,6 +6,7 @@ from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.group import Group
 from .raw_client import AsyncRawGroupsClient, RawGroupsClient
+from .types.groups_list_request_order import GroupsListRequestOrder
 
 
 class GroupsClient:
@@ -28,6 +29,11 @@ class GroupsClient:
         agent_id: str,
         *,
         manager_type: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[GroupsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Group]:
         """
@@ -40,6 +46,21 @@ class GroupsClient:
         manager_type : typing.Optional[str]
             Manager type to filter groups by
 
+        before : typing.Optional[str]
+            Group ID cursor for pagination. Returns groups that come before this group ID in the specified sort order
+
+        after : typing.Optional[str]
+            Group ID cursor for pagination. Returns groups that come after this group ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of groups to return
+
+        order : typing.Optional[GroupsListRequestOrder]
+            Sort order for groups 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.
 
@@ -58,9 +79,23 @@ class GroupsClient:
         )
         client.agents.groups.list(
             agent_id="agent_id",
+            manager_type="manager_type",
+            before="before",
+            after="after",
+            limit=1,
+            order="asc",
         )
         """
-        _response = self._raw_client.list(agent_id, manager_type=manager_type, request_options=request_options)
+        _response = self._raw_client.list(
+            agent_id,
+            manager_type=manager_type,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            request_options=request_options,
+        )
         return _response.data
 
 
@@ -84,6 +119,11 @@ class AsyncGroupsClient:
         agent_id: str,
         *,
         manager_type: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[GroupsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Group]:
         """
@@ -96,6 +136,21 @@ class AsyncGroupsClient:
         manager_type : typing.Optional[str]
             Manager type to filter groups by
 
+        before : typing.Optional[str]
+            Group ID cursor for pagination. Returns groups that come before this group ID in the specified sort order
+
+        after : typing.Optional[str]
+            Group ID cursor for pagination. Returns groups that come after this group ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of groups to return
+
+        order : typing.Optional[GroupsListRequestOrder]
+            Sort order for groups 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.
 
@@ -119,10 +174,24 @@ class AsyncGroupsClient:
         async def main() -> None:
             await client.agents.groups.list(
                 agent_id="agent_id",
+                manager_type="manager_type",
+                before="before",
+                after="after",
+                limit=1,
+                order="asc",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.list(agent_id, manager_type=manager_type, request_options=request_options)
+        _response = await self._raw_client.list(
+            agent_id,
+            manager_type=manager_type,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            request_options=request_options,
+        )
         return _response.data

letta_client/agents/groups/raw_client.py

@@ -12,6 +12,7 @@ from ...core.unchecked_base_model import construct_type
 from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.group import Group
 from ...types.http_validation_error import HttpValidationError
+from .types.groups_list_request_order import GroupsListRequestOrder
 
 
 class RawGroupsClient:
@@ -23,6 +24,11 @@ class RawGroupsClient:
         agent_id: str,
         *,
         manager_type: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[GroupsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[typing.List[Group]]:
         """
@@ -35,6 +41,21 @@ class RawGroupsClient:
         manager_type : typing.Optional[str]
             Manager type to filter groups by
 
+        before : typing.Optional[str]
+            Group ID cursor for pagination. Returns groups that come before this group ID in the specified sort order
+
+        after : typing.Optional[str]
+            Group ID cursor for pagination. Returns groups that come after this group ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of groups to return
+
+        order : typing.Optional[GroupsListRequestOrder]
+            Sort order for groups 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.
 
@@ -48,6 +69,11 @@ class RawGroupsClient:
             method="GET",
             params={
                 "manager_type": manager_type,
+                "before": before,
+                "after": after,
+                "limit": limit,
+                "order": order,
+                "order_by": order_by,
             },
             request_options=request_options,
         )
@@ -87,6 +113,11 @@ class AsyncRawGroupsClient:
         agent_id: str,
         *,
         manager_type: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[GroupsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[typing.List[Group]]:
         """
@@ -99,6 +130,21 @@ class AsyncRawGroupsClient:
         manager_type : typing.Optional[str]
             Manager type to filter groups by
 
+        before : typing.Optional[str]
+            Group ID cursor for pagination. Returns groups that come before this group ID in the specified sort order
+
+        after : typing.Optional[str]
+            Group ID cursor for pagination. Returns groups that come after this group ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of groups to return
+
+        order : typing.Optional[GroupsListRequestOrder]
+            Sort order for groups 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.
 
@@ -112,6 +158,11 @@ class AsyncRawGroupsClient:
             method="GET",
             params={
                 "manager_type": manager_type,
+                "before": before,
+                "after": after,
+                "limit": limit,
+                "order": order,
+                "order_by": order_by,
             },
             request_options=request_options,
         )

letta_client/agents/groups/types/__init__.py

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

letta_client/agents/groups/types/groups_list_request_order.py

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

letta_client/agents/messages/__init__.py

@@ -6,6 +6,7 @@ from .types import (
     LettaAsyncRequestMessagesItem,
     LettaStreamingResponse,
     MessageSearchRequestSearchMode,
+    MessagesListRequestOrder,
     MessagesModifyRequest,
     MessagesModifyResponse,
     MessagesPreviewRequest,
@@ -15,6 +16,7 @@ __all__ = [
     "LettaAsyncRequestMessagesItem",
     "LettaStreamingResponse",
     "MessageSearchRequestSearchMode",
+    "MessagesListRequestOrder",
     "MessagesModifyRequest",
     "MessagesModifyResponse",
     "MessagesPreviewRequest",