letta-client 1.0.0a1__py3-none-any.whl → 1.0.0a3__py3-none-any.whl

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",

letta_client/agents/messages/client.py

@@ -18,6 +18,7 @@ from .raw_client import AsyncRawMessagesClient, RawMessagesClient
 from .types.letta_async_request_messages_item import LettaAsyncRequestMessagesItem
 from .types.letta_streaming_response import LettaStreamingResponse
 from .types.message_search_request_search_mode import MessageSearchRequestSearchMode
+from .types.messages_list_request_order import MessagesListRequestOrder
 from .types.messages_modify_request import MessagesModifyRequest
 from .types.messages_modify_response import MessagesModifyResponse
 from .types.messages_preview_request import MessagesPreviewRequest
@@ -45,9 +46,11 @@ class MessagesClient:
         self,
         agent_id: str,
         *,
-        after: typing.Optional[str] = None,
         before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[MessagesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
         group_id: typing.Optional[str] = None,
         use_assistant_message: typing.Optional[bool] = None,
         assistant_message_tool_name: typing.Optional[str] = None,
@@ -62,14 +65,20 @@ class MessagesClient:
         ----------
         agent_id : str
 
-        after : typing.Optional[str]
-            Message after which to retrieve the returned messages.
-
         before : typing.Optional[str]
-            Message before which to retrieve the returned messages.
+            Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
+
+        after : typing.Optional[str]
+            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 retrieve.
+            Maximum number of messages to return
+
+        order : typing.Optional[MessagesListRequestOrder]
+            Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
 
         group_id : typing.Optional[str]
             Group ID to filter messages by.
@@ -104,13 +113,24 @@ class MessagesClient:
         )
         client.agents.messages.list(
             agent_id="agent_id",
+            before="before",
+            after="after",
+            limit=1,
+            order="asc",
+            group_id="group_id",
+            use_assistant_message=True,
+            assistant_message_tool_name="assistant_message_tool_name",
+            assistant_message_tool_kwarg="assistant_message_tool_kwarg",
+            include_err=True,
         )
         """
         _response = self._raw_client.list(
             agent_id,
-            after=after,
             before=before,
+            after=after,
             limit=limit,
+            order=order,
+            order_by=order_by,
             group_id=group_id,
             use_assistant_message=use_assistant_message,
             assistant_message_tool_name=assistant_message_tool_name,
@@ -598,6 +618,7 @@ class MessagesClient:
         )
         client.agents.messages.reset(
             agent_id="agent_id",
+            add_default_initial_messages=True,
         )
         """
         _response = self._raw_client.reset(
@@ -717,9 +738,11 @@ class AsyncMessagesClient:
         self,
         agent_id: str,
         *,
-        after: typing.Optional[str] = None,
         before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[MessagesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
         group_id: typing.Optional[str] = None,
         use_assistant_message: typing.Optional[bool] = None,
         assistant_message_tool_name: typing.Optional[str] = None,
@@ -734,14 +757,20 @@ class AsyncMessagesClient:
         ----------
         agent_id : str
 
-        after : typing.Optional[str]
-            Message after which to retrieve the returned messages.
-
         before : typing.Optional[str]
-            Message before which to retrieve the returned messages.
+            Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
+
+        after : typing.Optional[str]
+            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 retrieve.
+            Maximum number of messages to return
+
+        order : typing.Optional[MessagesListRequestOrder]
+            Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
 
         group_id : typing.Optional[str]
             Group ID to filter messages by.
@@ -781,6 +810,15 @@ class AsyncMessagesClient:
         async def main() -> None:
             await client.agents.messages.list(
                 agent_id="agent_id",
+                before="before",
+                after="after",
+                limit=1,
+                order="asc",
+                group_id="group_id",
+                use_assistant_message=True,
+                assistant_message_tool_name="assistant_message_tool_name",
+                assistant_message_tool_kwarg="assistant_message_tool_kwarg",
+                include_err=True,
             )
 
 
@@ -788,9 +826,11 @@ class AsyncMessagesClient:
         """
         _response = await self._raw_client.list(
             agent_id,
-            after=after,
             before=before,
+            after=after,
             limit=limit,
+            order=order,
+            order_by=order_by,
             group_id=group_id,
             use_assistant_message=use_assistant_message,
             assistant_message_tool_name=assistant_message_tool_name,
@@ -1334,6 +1374,7 @@ class AsyncMessagesClient:
         async def main() -> None:
             await client.agents.messages.reset(
                 agent_id="agent_id",
+                add_default_initial_messages=True,
             )