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

letta_client/agents/messages/raw_client.py

@@ -28,6 +28,7 @@ from ...types.run import Run
 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
@@ -44,9 +45,11 @@ class RawMessagesClient:
         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,
@@ -61,14 +64,20 @@ class RawMessagesClient:
         ----------
         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.
@@ -97,9 +106,11 @@ class RawMessagesClient:
             f"v1/agents/{jsonable_encoder(agent_id)}/messages",
             method="GET",
             params={
-                "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,
@@ -871,9 +882,11 @@ class AsyncRawMessagesClient:
         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,
@@ -888,14 +901,20 @@ class AsyncRawMessagesClient:
         ----------
         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.
@@ -924,9 +943,11 @@ class AsyncRawMessagesClient:
             f"v1/agents/{jsonable_encoder(agent_id)}/messages",
             method="GET",
             params={
-                "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,

letta_client/agents/messages/types/__init__.py

@@ -5,6 +5,7 @@
 from .letta_async_request_messages_item import LettaAsyncRequestMessagesItem
 from .letta_streaming_response import LettaStreamingResponse
 from .message_search_request_search_mode import MessageSearchRequestSearchMode
+from .messages_list_request_order import MessagesListRequestOrder
 from .messages_modify_request import MessagesModifyRequest
 from .messages_modify_response import MessagesModifyResponse
 from .messages_preview_request import MessagesPreviewRequest
@@ -13,6 +14,7 @@ __all__ = [
     "LettaAsyncRequestMessagesItem",
     "LettaStreamingResponse",
     "MessageSearchRequestSearchMode",
+    "MessagesListRequestOrder",
     "MessagesModifyRequest",
     "MessagesModifyResponse",
     "MessagesPreviewRequest",

letta_client/agents/messages/types/messages_list_request_order.py

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

letta_client/agents/passages/client.py

@@ -80,6 +80,11 @@ class PassagesClient:
         )
         client.agents.passages.list(
             agent_id="agent_id",
+            after="after",
+            before="before",
+            limit=1,
+            search="search",
+            ascending=True,
         )
         """
         _response = self._raw_client.list(
@@ -195,6 +200,8 @@ class PassagesClient:
 
         Examples
         --------
+        import datetime
+
         from letta_client import Letta
 
         client = Letta(
@@ -204,6 +211,14 @@ class PassagesClient:
         client.agents.passages.search(
             agent_id="agent_id",
             query="query",
+            tag_match_mode="any",
+            top_k=1,
+            start_datetime=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
+            end_datetime=datetime.datetime.fromisoformat(
+                "2024-01-15 09:30:00+00:00",
+            ),
         )
         """
         _response = self._raw_client.search(
@@ -357,6 +372,11 @@ class AsyncPassagesClient:
         async def main() -> None:
             await client.agents.passages.list(
                 agent_id="agent_id",
+                after="after",
+                before="before",
+                limit=1,
+                search="search",
+                ascending=True,
             )
 
 
@@ -484,6 +504,7 @@ class AsyncPassagesClient:
         Examples
         --------
         import asyncio
+        import datetime
 
         from letta_client import AsyncLetta
 
@@ -497,6 +518,14 @@ class AsyncPassagesClient:
             await client.agents.passages.search(
                 agent_id="agent_id",
                 query="query",
+                tag_match_mode="any",
+                top_k=1,
+                start_datetime=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
+                end_datetime=datetime.datetime.fromisoformat(
+                    "2024-01-15 09:30:00+00:00",
+                ),
             )
 
 

letta_client/agents/raw_client.py

@@ -311,10 +311,10 @@ class RawAgentsClient:
             Whether to enable reasoning for this agent.
 
         from_template : typing.Optional[str]
-            The template id used to configure the agent
+            Deprecated: please use the 'create agents from a template' endpoint instead.
 
         template : typing.Optional[bool]
-            Whether the agent is a template
+            Deprecated: No longer used
 
         project : typing.Optional[str]
             Deprecated: Project should now be passed via the X-Project header instead of in the request body. If using the sdk, this can be done via the new x_project field below.
@@ -1352,10 +1352,10 @@ class AsyncRawAgentsClient:
             Whether to enable reasoning for this agent.
 
         from_template : typing.Optional[str]
-            The template id used to configure the agent
+            Deprecated: please use the 'create agents from a template' endpoint instead.
 
         template : typing.Optional[bool]
-            Whether the agent is a template
+            Deprecated: No longer used
 
         project : typing.Optional[str]
             Deprecated: Project should now be passed via the X-Project header instead of in the request body. If using the sdk, this can be done via the new x_project field below.

letta_client/agents/sources/__init__.py

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

letta_client/agents/sources/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 AsyncRawSourcesClient, RawSourcesClient
+from .types.sources_list_request_order import SourcesListRequestOrder
 
 
 class SourcesClient:
@@ -96,7 +97,17 @@ class SourcesClient:
         _response = self._raw_client.detach(agent_id, source_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[SourcesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[Source]:
         """
         Get the sources associated with an agent.
 
@@ -104,6 +115,21 @@ class SourcesClient:
         ----------
         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[SourcesListRequestOrder]
+            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 SourcesClient:
         )
         client.agents.sources.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 AsyncSourcesClient:
         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[SourcesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Source]:
         """
         Get the sources associated with an agent.
@@ -241,6 +287,21 @@ class AsyncSourcesClient:
         ----------
         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[SourcesListRequestOrder]
+            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 AsyncSourcesClient:
         async def main() -> None:
             await client.agents.sources.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/sources/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.sources_list_request_order import SourcesListRequestOrder
 
 
 class RawSourcesClient:
@@ -122,7 +123,15 @@ class RawSourcesClient:
         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[SourcesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[typing.List[Source]]:
         """
         Get the sources associated with an agent.
@@ -131,6 +140,21 @@ class RawSourcesClient:
         ----------
         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[SourcesListRequestOrder]
+            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 RawSourcesClient:
         _response = self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}/sources",
             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 AsyncRawSourcesClient:
         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[SourcesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[typing.List[Source]]:
         """
         Get the sources associated with an agent.
@@ -287,6 +326,21 @@ class AsyncRawSourcesClient:
         ----------
         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[SourcesListRequestOrder]
+            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 AsyncRawSourcesClient:
         _response = await self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}/sources",
             method="GET",
+            params={
+                "before": before,
+                "after": after,
+                "limit": limit,
+                "order": order,
+                "order_by": order_by,
+            },
             request_options=request_options,
         )
         try:

letta_client/agents/sources/types/__init__.py

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

letta_client/agents/sources/types/sources_list_request_order.py

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

letta_client/agents/tools/__init__.py

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

letta_client/agents/tools/client.py

@@ -7,6 +7,7 @@ from ...core.request_options import RequestOptions
 from ...types.agent_state import AgentState
 from ...types.tool import Tool
 from .raw_client import AsyncRawToolsClient, RawToolsClient
+from .types.tools_list_request_order import ToolsListRequestOrder
 
 
 class ToolsClient:
@@ -24,7 +25,17 @@ class ToolsClient:
         """
         return self._raw_client
 
-    def list(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Tool]:
+    def list(
+        self,
+        agent_id: str,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[ToolsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[Tool]:
         """
         Get tools from an existing agent
 
@@ -32,6 +43,21 @@ class ToolsClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Tool ID cursor for pagination. Returns tools that come before this tool ID in the specified sort order
+
+        after : typing.Optional[str]
+            Tool ID cursor for pagination. Returns tools that come after this tool ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of tools to return
+
+        order : typing.Optional[ToolsListRequestOrder]
+            Sort order for tools 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.
 
@@ -50,9 +76,21 @@ class ToolsClient:
         )
         client.agents.tools.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
 
     def attach(
@@ -190,7 +228,15 @@ class AsyncToolsClient:
         return self._raw_client
 
     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[ToolsListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Tool]:
         """
         Get tools from an existing agent
@@ -199,6 +245,21 @@ class AsyncToolsClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Tool ID cursor for pagination. Returns tools that come before this tool ID in the specified sort order
+
+        after : typing.Optional[str]
+            Tool ID cursor for pagination. Returns tools that come after this tool ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of tools to return
+
+        order : typing.Optional[ToolsListRequestOrder]
+            Sort order for tools 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.
 
@@ -222,12 +283,24 @@ class AsyncToolsClient:
         async def main() -> None:
             await client.agents.tools.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
 
     async def attach(