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

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,
@@ -489,8 +509,7 @@ class MessagesClient:
         Asynchronously process a user message and return a run object.
         The actual processing happens in the background, and the status can be checked using the run ID.
 
-        This is "asynchronous" in the sense that it's a background job and explicitly must be fetched by the run ID.
-        This is more like `send_message_job`
+        This is "asynchronous" in the sense that it's a background run and explicitly must be fetched by the run ID.
 
         Parameters
         ----------
@@ -599,6 +618,7 @@ class MessagesClient:
         )
         client.agents.messages.reset(
             agent_id="agent_id",
+            add_default_initial_messages=True,
         )
         """
         _response = self._raw_client.reset(
@@ -718,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,
@@ -735,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.
@@ -782,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,
             )
 
 
@@ -789,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,
@@ -1213,8 +1252,7 @@ class AsyncMessagesClient:
         Asynchronously process a user message and return a run object.
         The actual processing happens in the background, and the status can be checked using the run ID.
 
-        This is "asynchronous" in the sense that it's a background job and explicitly must be fetched by the run ID.
-        This is more like `send_message_job`
+        This is "asynchronous" in the sense that it's a background run and explicitly must be fetched by the run ID.
 
         Parameters
         ----------
@@ -1336,6 +1374,7 @@ class AsyncMessagesClient:
         async def main() -> None:
             await client.agents.messages.reset(
                 agent_id="agent_id",
+                add_default_initial_messages=True,
             )
 
 

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,
@@ -606,8 +617,7 @@ class RawMessagesClient:
         Asynchronously process a user message and return a run object.
         The actual processing happens in the background, and the status can be checked using the run ID.
 
-        This is "asynchronous" in the sense that it's a background job and explicitly must be fetched by the run ID.
-        This is more like `send_message_job`
+        This is "asynchronous" in the sense that it's a background run and explicitly must be fetched by the run ID.
 
         Parameters
         ----------
@@ -872,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,
@@ -889,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.
@@ -925,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,
@@ -1434,8 +1454,7 @@ class AsyncRawMessagesClient:
         Asynchronously process a user message and return a run object.
         The actual processing happens in the background, and the status can be checked using the run ID.
 
-        This is "asynchronous" in the sense that it's a background job and explicitly must be fetched by the run ID.
-        This is more like `send_message_job`
+        This is "asynchronous" in the sense that it's a background run and explicitly must be fetched by the run ID.
 
         Parameters
         ----------

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