letta-client 0.1.19__py3-none-any.whl → 0.1.22__py3-none-any.whl

letta_client/agents/memory_variables/client.py

@@ -48,7 +48,7 @@ class MemoryVariablesClient:
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/core_memory/variables",
+            f"v1/agents/{jsonable_encoder(agent_id)}/core-memory/variables",
             method="GET",
             request_options=request_options,
         )
@@ -121,7 +121,7 @@ class AsyncMemoryVariablesClient:
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/core_memory/variables",
+            f"v1/agents/{jsonable_encoder(agent_id)}/core-memory/variables",
             method="GET",
             request_options=request_options,
         )

letta_client/agents/messages/__init__.py

@@ -1,5 +1,5 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from .types import LettaStreamingResponse, MessagesListResponse
+from .types import LettaStreamingResponse, MessageUpdateContent, MessagesListResponse
 
-__all__ = ["LettaStreamingResponse", "MessagesListResponse"]
+__all__ = ["LettaStreamingResponse", "MessageUpdateContent", "MessagesListResponse"]

letta_client/agents/messages/client.py

@@ -15,6 +15,7 @@ from ...types.letta_request_config import LettaRequestConfig
 from ...types.letta_response import LettaResponse
 from ...core.serialization import convert_and_respect_annotation_metadata
 from ...types.message_role import MessageRole
+from .types.message_update_content import MessageUpdateContent
 from ...types.chat_completion_message_tool_call import ChatCompletionMessageToolCall
 from ...types.message import Message
 from .types.letta_streaming_response import LettaStreamingResponse
@@ -35,6 +36,7 @@ class MessagesClient:
         self,
         agent_id: str,
         *,
+        after: typing.Optional[str] = None,
         before: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         msg_object: typing.Optional[bool] = None,
@@ -49,6 +51,9 @@ 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.
 
@@ -87,6 +92,7 @@ class MessagesClient:
             f"v1/agents/{jsonable_encoder(agent_id)}/messages",
             method="GET",
             params={
+                "after": after,
                 "before": before,
                 "limit": limit,
                 "msg_object": msg_object,
@@ -161,7 +167,7 @@ class MessagesClient:
             messages=[
                 MessageCreate(
                     role="user",
-                    text="text",
+                    content="content",
                 )
             ],
         )
@@ -210,7 +216,7 @@ class MessagesClient:
         message_id: str,
         *,
         role: typing.Optional[MessageRole] = OMIT,
-        text: typing.Optional[str] = OMIT,
+        content: typing.Optional[MessageUpdateContent] = OMIT,
         name: typing.Optional[str] = OMIT,
         tool_calls: typing.Optional[typing.Sequence[ChatCompletionMessageToolCall]] = OMIT,
         tool_call_id: typing.Optional[str] = OMIT,
@@ -228,8 +234,8 @@ class MessagesClient:
         role : typing.Optional[MessageRole]
             The role of the participant.
 
-        text : typing.Optional[str]
-            The text of the message.
+        content : typing.Optional[MessageUpdateContent]
+            The content of the message.
 
         name : typing.Optional[str]
             The name of the participant.
@@ -265,7 +271,9 @@ class MessagesClient:
             method="PATCH",
             json={
                 "role": role,
-                "text": text,
+                "content": convert_and_respect_annotation_metadata(
+                    object_=content, annotation=MessageUpdateContent, direction="write"
+                ),
                 "name": name,
                 "tool_calls": convert_and_respect_annotation_metadata(
                     object_=tool_calls, annotation=typing.Sequence[ChatCompletionMessageToolCall], direction="write"
@@ -349,7 +357,7 @@ class MessagesClient:
             messages=[
                 MessageCreate(
                     role="user",
-                    text="text",
+                    content="content",
                 )
             ],
         )
@@ -447,7 +455,7 @@ class MessagesClient:
             messages=[
                 MessageCreate(
                     role="user",
-                    text="text",
+                    content="content",
                 )
             ],
         )
@@ -499,6 +507,7 @@ class AsyncMessagesClient:
         self,
         agent_id: str,
         *,
+        after: typing.Optional[str] = None,
         before: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         msg_object: typing.Optional[bool] = None,
@@ -513,6 +522,9 @@ 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.
 
@@ -559,6 +571,7 @@ class AsyncMessagesClient:
             f"v1/agents/{jsonable_encoder(agent_id)}/messages",
             method="GET",
             params={
+                "after": after,
                 "before": before,
                 "limit": limit,
                 "msg_object": msg_object,
@@ -638,7 +651,7 @@ class AsyncMessagesClient:
                 messages=[
                     MessageCreate(
                         role="user",
-                        text="text",
+                        content="content",
                     )
                 ],
             )
@@ -690,7 +703,7 @@ class AsyncMessagesClient:
         message_id: str,
         *,
         role: typing.Optional[MessageRole] = OMIT,
-        text: typing.Optional[str] = OMIT,
+        content: typing.Optional[MessageUpdateContent] = OMIT,
         name: typing.Optional[str] = OMIT,
         tool_calls: typing.Optional[typing.Sequence[ChatCompletionMessageToolCall]] = OMIT,
         tool_call_id: typing.Optional[str] = OMIT,
@@ -708,8 +721,8 @@ class AsyncMessagesClient:
         role : typing.Optional[MessageRole]
             The role of the participant.
 
-        text : typing.Optional[str]
-            The text of the message.
+        content : typing.Optional[MessageUpdateContent]
+            The content of the message.
 
         name : typing.Optional[str]
             The name of the participant.
@@ -753,7 +766,9 @@ class AsyncMessagesClient:
             method="PATCH",
             json={
                 "role": role,
-                "text": text,
+                "content": convert_and_respect_annotation_metadata(
+                    object_=content, annotation=MessageUpdateContent, direction="write"
+                ),
                 "name": name,
                 "tool_calls": convert_and_respect_annotation_metadata(
                     object_=tool_calls, annotation=typing.Sequence[ChatCompletionMessageToolCall], direction="write"
@@ -842,7 +857,7 @@ class AsyncMessagesClient:
                 messages=[
                     MessageCreate(
                         role="user",
-                        text="text",
+                        content="content",
                     )
                 ],
             )
@@ -948,7 +963,7 @@ class AsyncMessagesClient:
                 messages=[
                     MessageCreate(
                         role="user",
-                        text="text",
+                        content="content",
                     )
                 ],
             )

letta_client/agents/messages/types/__init__.py

@@ -1,6 +1,7 @@
 # This file was auto-generated by Fern from our API Definition.
 
 from .letta_streaming_response import LettaStreamingResponse
+from .message_update_content import MessageUpdateContent
 from .messages_list_response import MessagesListResponse
 
-__all__ = ["LettaStreamingResponse", "MessagesListResponse"]
+__all__ = ["LettaStreamingResponse", "MessageUpdateContent", "MessagesListResponse"]

letta_client/agents/messages/types/message_update_content.py

@@ -0,0 +1,6 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from ....types.text_content import TextContent
+
+MessageUpdateContent = typing.Union[str, typing.List[TextContent]]

letta_client/blocks/client.py

@@ -10,6 +10,7 @@ from ..types.http_validation_error import HttpValidationError
 from json.decoder import JSONDecodeError
 from ..core.api_error import ApiError
 from ..core.jsonable_encoder import jsonable_encoder
+from ..types.agent_state import AgentState
 from ..core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -390,6 +391,65 @@ class BlocksClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def list_agents_for_block(
+        self, block_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[AgentState]:
+        """
+        Retrieves all agents associated with the specified block.
+        Raises a 404 if the block does not exist.
+
+        Parameters
+        ----------
+        block_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[AgentState]
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.blocks.list_agents_for_block(
+            block_id="block_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/blocks/{jsonable_encoder(block_id)}/agents",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[AgentState],
+                    construct_type(
+                        type_=typing.List[AgentState],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
 
 class AsyncBlocksClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -804,3 +864,70 @@ class AsyncBlocksClient:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def list_agents_for_block(
+        self, block_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[AgentState]:
+        """
+        Retrieves all agents associated with the specified block.
+        Raises a 404 if the block does not exist.
+
+        Parameters
+        ----------
+        block_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[AgentState]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.blocks.list_agents_for_block(
+                block_id="block_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/blocks/{jsonable_encoder(block_id)}/agents",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[AgentState],
+                    construct_type(
+                        type_=typing.List[AgentState],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)

letta_client/client.py

@@ -31,7 +31,6 @@ class ToolsClient(ToolsClientBase):
         self,
         *,
         func: typing.Callable,
-        name: typing.Optional[str] = OMIT,
         description: typing.Optional[str] = OMIT,
         tags: typing.Optional[typing.Sequence[str]] = OMIT,
         source_type: typing.Optional[str] = OMIT,
@@ -44,7 +43,6 @@ class ToolsClient(ToolsClientBase):
         source_code = dedent(inspect.getsource(func))
         return self.create(
             source_code=source_code,
-            name=name,
             description=description,
             tags=tags,
             source_type=source_type,
@@ -57,7 +55,6 @@ class ToolsClient(ToolsClientBase):
         self,
         *,
         func: typing.Callable,
-        name: typing.Optional[str] = OMIT,
         description: typing.Optional[str] = OMIT,
         tags: typing.Optional[typing.Sequence[str]] = OMIT,
         source_type: typing.Optional[str] = OMIT,
@@ -70,7 +67,6 @@ class ToolsClient(ToolsClientBase):
         source_code = dedent(inspect.getsource(func))
         return self.upsert(
             source_code=source_code,
-            name=name,
             description=description,
             tags=tags,
             source_type=source_type,

letta_client/core/client_wrapper.py

@@ -16,7 +16,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.19",
+            "X-Fern-SDK-Version": "0.1.22",
         }
         if self.token is not None:
             headers["Authorization"] = f"Bearer {self.token}"

letta_client/providers/client.py

@@ -22,7 +22,7 @@ class ProvidersClient:
     def list_providers(
         self,
         *,
-        cursor: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Provider]:
@@ -31,7 +31,7 @@ class ProvidersClient:
 
         Parameters
         ----------
-        cursor : typing.Optional[str]
+        after : typing.Optional[str]
 
         limit : typing.Optional[int]
 
@@ -56,7 +56,7 @@ class ProvidersClient:
             "v1/providers/",
             method="GET",
             params={
-                "cursor": cursor,
+                "after": after,
                 "limit": limit,
             },
             request_options=request_options,
@@ -297,7 +297,7 @@ class AsyncProvidersClient:
     async def list_providers(
         self,
         *,
-        cursor: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Provider]:
@@ -306,7 +306,7 @@ class AsyncProvidersClient:
 
         Parameters
         ----------
-        cursor : typing.Optional[str]
+        after : typing.Optional[str]
 
         limit : typing.Optional[int]
 
@@ -339,7 +339,7 @@ class AsyncProvidersClient:
             "v1/providers/",
             method="GET",
             params={
-                "cursor": cursor,
+                "after": after,
                 "limit": limit,
             },
             request_options=request_options,

letta_client/runs/client.py

@@ -240,9 +240,10 @@ class RunsClient:
         self,
         run_id: str,
         *,
-        cursor: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
-        ascending: typing.Optional[bool] = None,
+        order: typing.Optional[str] = None,
         role: typing.Optional[MessageRole] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[LettaMessageUnion]:
@@ -251,9 +252,10 @@ class RunsClient:
 
         Args:
             run_id: ID of the run
-            cursor: Cursor for pagination
+            before: A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
+            after: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
             limit: Maximum number of messages to return
-            ascending: Sort order by creation time
+            order: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
             role: Filter by role (user/assistant/system/tool)
             return_message_object: Whether to return Message objects or LettaMessage objects
             user_id: ID of the user making the request
@@ -265,14 +267,17 @@ class RunsClient:
         ----------
         run_id : str
 
-        cursor : typing.Optional[str]
+        before : typing.Optional[str]
+            Cursor for pagination
+
+        after : typing.Optional[str]
             Cursor for pagination
 
         limit : typing.Optional[int]
             Maximum number of messages to return
 
-        ascending : typing.Optional[bool]
-            Sort order by creation time
+        order : typing.Optional[str]
+            Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
 
         role : typing.Optional[MessageRole]
             Filter by role
@@ -300,9 +305,10 @@ class RunsClient:
             f"v1/runs/{jsonable_encoder(run_id)}/messages",
             method="GET",
             params={
-                "cursor": cursor,
+                "before": before,
+                "after": after,
                 "limit": limit,
-                "ascending": ascending,
+                "order": order,
                 "role": role,
             },
             request_options=request_options,
@@ -646,9 +652,10 @@ class AsyncRunsClient:
         self,
         run_id: str,
         *,
-        cursor: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
-        ascending: typing.Optional[bool] = None,
+        order: typing.Optional[str] = None,
         role: typing.Optional[MessageRole] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[LettaMessageUnion]:
@@ -657,9 +664,10 @@ class AsyncRunsClient:
 
         Args:
             run_id: ID of the run
-            cursor: Cursor for pagination
+            before: A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
+            after: A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
             limit: Maximum number of messages to return
-            ascending: Sort order by creation time
+            order: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
             role: Filter by role (user/assistant/system/tool)
             return_message_object: Whether to return Message objects or LettaMessage objects
             user_id: ID of the user making the request
@@ -671,14 +679,17 @@ class AsyncRunsClient:
         ----------
         run_id : str
 
-        cursor : typing.Optional[str]
+        before : typing.Optional[str]
+            Cursor for pagination
+
+        after : typing.Optional[str]
             Cursor for pagination
 
         limit : typing.Optional[int]
             Maximum number of messages to return
 
-        ascending : typing.Optional[bool]
-            Sort order by creation time
+        order : typing.Optional[str]
+            Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.
 
         role : typing.Optional[MessageRole]
             Filter by role
@@ -714,9 +725,10 @@ class AsyncRunsClient:
             f"v1/runs/{jsonable_encoder(run_id)}/messages",
             method="GET",
             params={
-                "cursor": cursor,
+                "before": before,
+                "after": after,
                 "limit": limit,
-                "ascending": ascending,
+                "order": order,
                 "role": role,
             },
             request_options=request_options,

letta_client/sources/files/client.py

@@ -93,7 +93,7 @@ class FilesClient:
         source_id: str,
         *,
         limit: typing.Optional[int] = None,
-        cursor: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[FileMetadata]:
         """
@@ -106,7 +106,7 @@ class FilesClient:
         limit : typing.Optional[int]
             Number of files to return
 
-        cursor : typing.Optional[str]
+        after : typing.Optional[str]
             Pagination cursor to fetch the next set of results
 
         request_options : typing.Optional[RequestOptions]
@@ -133,7 +133,7 @@ class FilesClient:
             method="GET",
             params={
                 "limit": limit,
-                "cursor": cursor,
+                "after": after,
             },
             request_options=request_options,
         )
@@ -297,7 +297,7 @@ class AsyncFilesClient:
         source_id: str,
         *,
         limit: typing.Optional[int] = None,
-        cursor: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[FileMetadata]:
         """
@@ -310,7 +310,7 @@ class AsyncFilesClient:
         limit : typing.Optional[int]
             Number of files to return
 
-        cursor : typing.Optional[str]
+        after : typing.Optional[str]
             Pagination cursor to fetch the next set of results
 
         request_options : typing.Optional[RequestOptions]
@@ -345,7 +345,7 @@ class AsyncFilesClient:
             method="GET",
             params={
                 "limit": limit,
-                "cursor": cursor,
+                "after": after,
             },
             request_options=request_options,
         )

letta_client/tag/client.py

@@ -18,7 +18,7 @@ class TagClient:
     def list_tags(
         self,
         *,
-        cursor: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         query_text: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
@@ -28,7 +28,7 @@ class TagClient:
 
         Parameters
         ----------
-        cursor : typing.Optional[str]
+        after : typing.Optional[str]
 
         limit : typing.Optional[int]
 
@@ -55,7 +55,7 @@ class TagClient:
             "v1/tags/",
             method="GET",
             params={
-                "cursor": cursor,
+                "after": after,
                 "limit": limit,
                 "query_text": query_text,
             },
@@ -93,7 +93,7 @@ class AsyncTagClient:
     async def list_tags(
         self,
         *,
-        cursor: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
         query_text: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
@@ -103,7 +103,7 @@ class AsyncTagClient:
 
         Parameters
         ----------
-        cursor : typing.Optional[str]
+        after : typing.Optional[str]
 
         limit : typing.Optional[int]
 
@@ -138,7 +138,7 @@ class AsyncTagClient:
             "v1/tags/",
             method="GET",
             params={
-                "cursor": cursor,
+                "after": after,
                 "limit": limit,
                 "query_text": query_text,
             },