letta-client 1.0.0a6__py3-none-any.whl → 1.0.0a8__py3-none-any.whl

{letta_sdk → letta_client}/resources/groups/messages.py

@@ -17,11 +17,12 @@ from ..._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from ..._base_client import make_request_options
-from ...types.groups import message_list_params, message_send_params, message_update_params, message_send_stream_params
+from ...pagination import SyncArrayPage, AsyncArrayPage
+from ..._base_client import AsyncPaginator, make_request_options
+from ...types.groups import message_list_params, message_send_params, message_stream_params, message_update_params
 from ...types.agents.message_type import MessageType
 from ...types.agents.letta_response import LettaResponse
-from ...types.groups.message_list_response import MessageListResponse
+from ...types.agents.letta_message_union import LettaMessageUnion
 from ...types.groups.message_update_response import MessageUpdateResponse
 from ...types.agents.letta_user_message_content_union_param import LettaUserMessageContentUnionParam
 from ...types.agents.letta_assistant_message_content_union_param import LettaAssistantMessageContentUnionParam
@@ -68,6 +69,10 @@ class MessagesResource(SyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          message_id: The ID of the message in the format 'message-<uuid4>'
+
           content: The message content sent by the system (can be a string or an array of
               multi-modal content parts)
 
@@ -100,6 +105,10 @@ class MessagesResource(SyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          message_id: The ID of the message in the format 'message-<uuid4>'
+
           content: The message content sent by the user (can be a string or an array of multi-modal
               content parts)
 
@@ -132,6 +141,10 @@ class MessagesResource(SyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          message_id: The ID of the message in the format 'message-<uuid4>'
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -161,6 +174,10 @@ class MessagesResource(SyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          message_id: The ID of the message in the format 'message-<uuid4>'
+
           content: The message content sent by the assistant (can be a string or an array of
               content parts)
 
@@ -237,11 +254,13 @@ class MessagesResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> MessageListResponse:
+    ) -> SyncArrayPage[LettaMessageUnion]:
         """
         Retrieve message history for an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
           after: Message ID cursor for pagination. Returns messages that come after this message
               ID in the specified sort order
 
@@ -271,8 +290,9 @@ class MessagesResource(SyncAPIResource):
         """
         if not group_id:
             raise ValueError(f"Expected a non-empty value for `group_id` but received {group_id!r}")
-        return self._get(
+        return self._get_api_list(
             f"/v1/groups/{group_id}/messages",
+            page=SyncArrayPage[LettaMessageUnion],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -292,7 +312,42 @@ class MessagesResource(SyncAPIResource):
                     message_list_params.MessageListParams,
                 ),
             ),
-            cast_to=MessageListResponse,
+            model=cast(Any, LettaMessageUnion),  # Union types cannot be passed in as arguments in the type system
+        )
+
+    def reset(
+        self,
+        group_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> object:
+        """
+        Delete the group messages for all agents that are part of the multi-agent group.
+
+        Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not group_id:
+            raise ValueError(f"Expected a non-empty value for `group_id` but received {group_id!r}")
+        return self._patch(
+            f"/v1/groups/{group_id}/reset-messages",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
         )
 
     def send(
@@ -320,11 +375,15 @@ class MessagesResource(SyncAPIResource):
         on the specified pattern
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
           messages: The messages to be sent to the agent.
 
-          assistant_message_tool_kwarg: The name of the message argument in the designated message tool.
+          assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
+              for legacy agent types, but deprecated for letta_v1_agent onward.
 
-          assistant_message_tool_name: The name of the designated message tool.
+          assistant_message_tool_name: The name of the designated message tool. Still supported for legacy agent types,
+              but deprecated for letta_v1_agent onward.
 
           enable_thinking: If set to True, enables reasoning before responses or tool calls from the agent.
 
@@ -334,7 +393,8 @@ class MessagesResource(SyncAPIResource):
           max_steps: Maximum number of steps the agent should take to process the request.
 
           use_assistant_message: Whether the server should parse specific tool call arguments (default
-              `send_message`) as `AssistantMessage` objects.
+              `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
+              types, but deprecated for letta_v1_agent onward.
 
           extra_headers: Send extra headers
 
@@ -366,11 +426,11 @@ class MessagesResource(SyncAPIResource):
             cast_to=LettaResponse,
         )
 
-    def send_stream(
+    def stream(
         self,
         group_id: str,
         *,
-        messages: Iterable[message_send_stream_params.Message],
+        messages: Iterable[message_stream_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         background: bool | Omit = omit,
@@ -395,11 +455,15 @@ class MessagesResource(SyncAPIResource):
         the tokens if 'stream_tokens' is set to True.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
           messages: The messages to be sent to the agent.
 
-          assistant_message_tool_kwarg: The name of the message argument in the designated message tool.
+          assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
+              for legacy agent types, but deprecated for letta_v1_agent onward.
 
-          assistant_message_tool_name: The name of the designated message tool.
+          assistant_message_tool_name: The name of the designated message tool. Still supported for legacy agent types,
+              but deprecated for letta_v1_agent onward.
 
           background: Whether to process the request in the background.
 
@@ -417,7 +481,8 @@ class MessagesResource(SyncAPIResource):
               per step.
 
           use_assistant_message: Whether the server should parse specific tool call arguments (default
-              `send_message`) as `AssistantMessage` objects.
+              `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
+              types, but deprecated for letta_v1_agent onward.
 
           extra_headers: Send extra headers
 
@@ -444,7 +509,7 @@ class MessagesResource(SyncAPIResource):
                     "stream_tokens": stream_tokens,
                     "use_assistant_message": use_assistant_message,
                 },
-                message_send_stream_params.MessageSendStreamParams,
+                message_stream_params.MessageStreamParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -492,6 +557,10 @@ class AsyncMessagesResource(AsyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          message_id: The ID of the message in the format 'message-<uuid4>'
+
           content: The message content sent by the system (can be a string or an array of
               multi-modal content parts)
 
@@ -524,6 +593,10 @@ class AsyncMessagesResource(AsyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          message_id: The ID of the message in the format 'message-<uuid4>'
+
           content: The message content sent by the user (can be a string or an array of multi-modal
               content parts)
 
@@ -556,6 +629,10 @@ class AsyncMessagesResource(AsyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          message_id: The ID of the message in the format 'message-<uuid4>'
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -585,6 +662,10 @@ class AsyncMessagesResource(AsyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          message_id: The ID of the message in the format 'message-<uuid4>'
+
           content: The message content sent by the assistant (can be a string or an array of
               content parts)
 
@@ -643,7 +724,7 @@ class AsyncMessagesResource(AsyncAPIResource):
             ),
         )
 
-    async def list(
+    def list(
         self,
         group_id: str,
         *,
@@ -661,11 +742,13 @@ class AsyncMessagesResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> MessageListResponse:
+    ) -> AsyncPaginator[LettaMessageUnion, AsyncArrayPage[LettaMessageUnion]]:
         """
         Retrieve message history for an agent.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
           after: Message ID cursor for pagination. Returns messages that come after this message
               ID in the specified sort order
 
@@ -695,14 +778,15 @@ class AsyncMessagesResource(AsyncAPIResource):
         """
         if not group_id:
             raise ValueError(f"Expected a non-empty value for `group_id` but received {group_id!r}")
-        return await self._get(
+        return self._get_api_list(
             f"/v1/groups/{group_id}/messages",
+            page=AsyncArrayPage[LettaMessageUnion],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=await async_maybe_transform(
+                query=maybe_transform(
                     {
                         "after": after,
                         "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
@@ -716,7 +800,42 @@ class AsyncMessagesResource(AsyncAPIResource):
                     message_list_params.MessageListParams,
                 ),
             ),
-            cast_to=MessageListResponse,
+            model=cast(Any, LettaMessageUnion),  # Union types cannot be passed in as arguments in the type system
+        )
+
+    async def reset(
+        self,
+        group_id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> object:
+        """
+        Delete the group messages for all agents that are part of the multi-agent group.
+
+        Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not group_id:
+            raise ValueError(f"Expected a non-empty value for `group_id` but received {group_id!r}")
+        return await self._patch(
+            f"/v1/groups/{group_id}/reset-messages",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
         )
 
     async def send(
@@ -744,11 +863,15 @@ class AsyncMessagesResource(AsyncAPIResource):
         on the specified pattern
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
           messages: The messages to be sent to the agent.
 
-          assistant_message_tool_kwarg: The name of the message argument in the designated message tool.
+          assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
+              for legacy agent types, but deprecated for letta_v1_agent onward.
 
-          assistant_message_tool_name: The name of the designated message tool.
+          assistant_message_tool_name: The name of the designated message tool. Still supported for legacy agent types,
+              but deprecated for letta_v1_agent onward.
 
           enable_thinking: If set to True, enables reasoning before responses or tool calls from the agent.
 
@@ -758,7 +881,8 @@ class AsyncMessagesResource(AsyncAPIResource):
           max_steps: Maximum number of steps the agent should take to process the request.
 
           use_assistant_message: Whether the server should parse specific tool call arguments (default
-              `send_message`) as `AssistantMessage` objects.
+              `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
+              types, but deprecated for letta_v1_agent onward.
 
           extra_headers: Send extra headers
 
@@ -790,11 +914,11 @@ class AsyncMessagesResource(AsyncAPIResource):
             cast_to=LettaResponse,
         )
 
-    async def send_stream(
+    async def stream(
         self,
         group_id: str,
         *,
-        messages: Iterable[message_send_stream_params.Message],
+        messages: Iterable[message_stream_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         background: bool | Omit = omit,
@@ -819,11 +943,15 @@ class AsyncMessagesResource(AsyncAPIResource):
         the tokens if 'stream_tokens' is set to True.
 
         Args:
+          group_id: The ID of the group in the format 'group-<uuid4>'
+
           messages: The messages to be sent to the agent.
 
-          assistant_message_tool_kwarg: The name of the message argument in the designated message tool.
+          assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
+              for legacy agent types, but deprecated for letta_v1_agent onward.
 
-          assistant_message_tool_name: The name of the designated message tool.
+          assistant_message_tool_name: The name of the designated message tool. Still supported for legacy agent types,
+              but deprecated for letta_v1_agent onward.
 
           background: Whether to process the request in the background.
 
@@ -841,7 +969,8 @@ class AsyncMessagesResource(AsyncAPIResource):
               per step.
 
           use_assistant_message: Whether the server should parse specific tool call arguments (default
-              `send_message`) as `AssistantMessage` objects.
+              `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
+              types, but deprecated for letta_v1_agent onward.
 
           extra_headers: Send extra headers
 
@@ -868,7 +997,7 @@ class AsyncMessagesResource(AsyncAPIResource):
                     "stream_tokens": stream_tokens,
                     "use_assistant_message": use_assistant_message,
                 },
-                message_send_stream_params.MessageSendStreamParams,
+                message_stream_params.MessageStreamParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -887,11 +1016,14 @@ class MessagesResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             messages.list,
         )
+        self.reset = to_raw_response_wrapper(
+            messages.reset,
+        )
         self.send = to_raw_response_wrapper(
             messages.send,
         )
-        self.send_stream = to_raw_response_wrapper(
-            messages.send_stream,
+        self.stream = to_raw_response_wrapper(
+            messages.stream,
         )
 
 
@@ -905,11 +1037,14 @@ class AsyncMessagesResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             messages.list,
         )
+        self.reset = async_to_raw_response_wrapper(
+            messages.reset,
+        )
         self.send = async_to_raw_response_wrapper(
             messages.send,
         )
-        self.send_stream = async_to_raw_response_wrapper(
-            messages.send_stream,
+        self.stream = async_to_raw_response_wrapper(
+            messages.stream,
         )
 
 
@@ -923,11 +1058,14 @@ class MessagesResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             messages.list,
         )
+        self.reset = to_streamed_response_wrapper(
+            messages.reset,
+        )
         self.send = to_streamed_response_wrapper(
             messages.send,
         )
-        self.send_stream = to_streamed_response_wrapper(
-            messages.send_stream,
+        self.stream = to_streamed_response_wrapper(
+            messages.stream,
         )
 
 
@@ -941,9 +1079,12 @@ class AsyncMessagesResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             messages.list,
         )
+        self.reset = async_to_streamed_response_wrapper(
+            messages.reset,
+        )
         self.send = async_to_streamed_response_wrapper(
             messages.send,
         )
-        self.send_stream = async_to_streamed_response_wrapper(
-            messages.send_stream,
+        self.stream = async_to_streamed_response_wrapper(
+            messages.stream,
         )

letta_client/resources/identities/__init__.py

@@ -0,0 +1,61 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .agents import (
+    AgentsResource,
+    AsyncAgentsResource,
+    AgentsResourceWithRawResponse,
+    AsyncAgentsResourceWithRawResponse,
+    AgentsResourceWithStreamingResponse,
+    AsyncAgentsResourceWithStreamingResponse,
+)
+from .blocks import (
+    BlocksResource,
+    AsyncBlocksResource,
+    BlocksResourceWithRawResponse,
+    AsyncBlocksResourceWithRawResponse,
+    BlocksResourceWithStreamingResponse,
+    AsyncBlocksResourceWithStreamingResponse,
+)
+from .identities import (
+    IdentitiesResource,
+    AsyncIdentitiesResource,
+    IdentitiesResourceWithRawResponse,
+    AsyncIdentitiesResourceWithRawResponse,
+    IdentitiesResourceWithStreamingResponse,
+    AsyncIdentitiesResourceWithStreamingResponse,
+)
+from .properties import (
+    PropertiesResource,
+    AsyncPropertiesResource,
+    PropertiesResourceWithRawResponse,
+    AsyncPropertiesResourceWithRawResponse,
+    PropertiesResourceWithStreamingResponse,
+    AsyncPropertiesResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "PropertiesResource",
+    "AsyncPropertiesResource",
+    "PropertiesResourceWithRawResponse",
+    "AsyncPropertiesResourceWithRawResponse",
+    "PropertiesResourceWithStreamingResponse",
+    "AsyncPropertiesResourceWithStreamingResponse",
+    "AgentsResource",
+    "AsyncAgentsResource",
+    "AgentsResourceWithRawResponse",
+    "AsyncAgentsResourceWithRawResponse",
+    "AgentsResourceWithStreamingResponse",
+    "AsyncAgentsResourceWithStreamingResponse",
+    "BlocksResource",
+    "AsyncBlocksResource",
+    "BlocksResourceWithRawResponse",
+    "AsyncBlocksResourceWithRawResponse",
+    "BlocksResourceWithStreamingResponse",
+    "AsyncBlocksResourceWithStreamingResponse",
+    "IdentitiesResource",
+    "AsyncIdentitiesResource",
+    "IdentitiesResourceWithRawResponse",
+    "AsyncIdentitiesResourceWithRawResponse",
+    "IdentitiesResourceWithStreamingResponse",
+    "AsyncIdentitiesResourceWithStreamingResponse",
+]