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

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

@@ -3,12 +3,11 @@
 from __future__ import annotations
 
 from typing import Any, List, Union, Iterable, Optional, cast
-from datetime import datetime
 from typing_extensions import Literal, overload
 
 import httpx
 
-from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
+from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import required_args, maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
@@ -18,26 +17,24 @@ from ..._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from ..._base_client import make_request_options
+from ...pagination import SyncArrayPage, AsyncArrayPage
+from ..._base_client import AsyncPaginator, make_request_options
 from ...types.agents import (
     message_list_params,
     message_send_params,
+    message_reset_params,
     message_cancel_params,
-    message_search_params,
+    message_stream_params,
     message_update_params,
     message_send_async_params,
-    message_send_stream_params,
-    message_preview_raw_payload_params,
 )
 from ...types.agents.run import Run
-from ...types.agents.message_role import MessageRole
+from ...types.agent_state import AgentState
 from ...types.agents.message_type import MessageType
 from ...types.agents.letta_response import LettaResponse
-from ...types.agents.message_list_response import MessageListResponse
+from ...types.agents.letta_message_union import LettaMessageUnion
 from ...types.agents.message_cancel_response import MessageCancelResponse
-from ...types.agents.message_search_response import MessageSearchResponse
 from ...types.agents.message_update_response import MessageUpdateResponse
-from ...types.agents.message_preview_raw_payload_response import MessagePreviewRawPayloadResponse
 from ...types.agents.letta_user_message_content_union_param import LettaUserMessageContentUnionParam
 from ...types.agents.letta_assistant_message_content_union_param import LettaAssistantMessageContentUnionParam
 
@@ -83,6 +80,10 @@ class MessagesResource(SyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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)
 
@@ -115,6 +116,10 @@ class MessagesResource(SyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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)
 
@@ -147,6 +152,10 @@ class MessagesResource(SyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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
@@ -176,6 +185,10 @@ class MessagesResource(SyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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)
 
@@ -244,7 +257,9 @@ class MessagesResource(SyncAPIResource):
         before: Optional[str] | Omit = omit,
         group_id: Optional[str] | Omit = omit,
         include_err: Optional[bool] | Omit = omit,
-        limit: int | Omit = omit,
+        limit: Optional[int] | Omit = omit,
+        order: Literal["asc", "desc"] | Omit = omit,
+        order_by: Literal["created_at"] | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # 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.
@@ -252,25 +267,34 @@ 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:
-          after: Message after which to retrieve the returned messages.
+          agent_id: The ID of the agent in the format 'agent-<uuid4>'
+
+          after: Message ID cursor for pagination. Returns messages that come after this message
+              ID in the specified sort order
 
           assistant_message_tool_kwarg: The name of the message argument.
 
           assistant_message_tool_name: The name of the designated message tool.
 
-          before: Message before which to retrieve the returned messages.
+          before: Message ID cursor for pagination. Returns messages that come before this message
+              ID in the specified sort order
 
           group_id: Group ID to filter messages by.
 
           include_err: Whether to include error messages and error statuses. For debugging purposes
               only.
 
-          limit: Maximum number of messages to retrieve.
+          limit: Maximum number of messages to return
+
+          order: Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
+              newest first
+
+          order_by: Field to sort by
 
           use_assistant_message: Whether to use assistant messages
 
@@ -284,8 +308,9 @@ class MessagesResource(SyncAPIResource):
         """
         if not agent_id:
             raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return self._get(
+        return self._get_api_list(
             f"/v1/agents/{agent_id}/messages",
+            page=SyncArrayPage[LettaMessageUnion],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -300,12 +325,14 @@ class MessagesResource(SyncAPIResource):
                         "group_id": group_id,
                         "include_err": include_err,
                         "limit": limit,
+                        "order": order,
+                        "order_by": order_by,
                         "use_assistant_message": use_assistant_message,
                     },
                     message_list_params.MessageListParams,
                 ),
             ),
-            cast_to=MessageListResponse,
+            model=cast(Any, LettaMessageUnion),  # Union types cannot be passed in as arguments in the type system
         )
 
     def cancel(
@@ -328,6 +355,8 @@ class MessagesResource(SyncAPIResource):
         Note to cancel active runs associated with an agent, redis is required.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<uuid4>'
+
           run_ids: Optional list of run IDs to cancel
 
           extra_headers: Send extra headers
@@ -349,48 +378,25 @@ class MessagesResource(SyncAPIResource):
             cast_to=MessageCancelResponse,
         )
 
-    @overload
-    def preview_raw_payload(
+    def reset(
         self,
         agent_id: str,
         *,
-        messages: Iterable[message_preview_raw_payload_params.LettaRequestMessage],
-        assistant_message_tool_kwarg: str | Omit = omit,
-        assistant_message_tool_name: str | Omit = omit,
-        enable_thinking: str | Omit = omit,
-        include_return_message_types: Optional[List[MessageType]] | Omit = omit,
-        max_steps: int | Omit = omit,
-        use_assistant_message: bool | Omit = omit,
+        add_default_initial_messages: bool | Omit = omit,
         # 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,
-    ) -> MessagePreviewRawPayloadResponse:
+    ) -> AgentState:
         """
-        Inspect the raw LLM request payload without sending it.
-
-        This endpoint processes the message through the agent loop up until the LLM
-        request, then returns the raw request payload that would be sent to the LLM
-        provider. Useful for debugging and inspection.
+        Resets the messages for an agent
 
         Args:
-          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_name: The name of the designated message tool.
-
-          enable_thinking: If set to True, enables reasoning before responses or tool calls from the agent.
-
-          include_return_message_types: Only return specified message types in the response. If `None` (default) returns
-              all messages.
+          agent_id: The ID of the agent in the format 'agent-<uuid4>'
 
-          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.
+          add_default_initial_messages: If true, adds the default initial messages after resetting.
 
           extra_headers: Send extra headers
 
@@ -400,188 +406,17 @@ class MessagesResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        ...
-
-    @overload
-    def preview_raw_payload(
-        self,
-        agent_id: str,
-        *,
-        messages: Iterable[message_preview_raw_payload_params.LettaStreamingRequestMessage],
-        assistant_message_tool_kwarg: str | Omit = omit,
-        assistant_message_tool_name: str | Omit = omit,
-        background: bool | Omit = omit,
-        enable_thinking: str | Omit = omit,
-        include_pings: bool | Omit = omit,
-        include_return_message_types: Optional[List[MessageType]] | Omit = omit,
-        max_steps: int | Omit = omit,
-        stream_tokens: bool | Omit = omit,
-        use_assistant_message: bool | Omit = omit,
-        # 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,
-    ) -> MessagePreviewRawPayloadResponse:
-        """
-        Inspect the raw LLM request payload without sending it.
-
-        This endpoint processes the message through the agent loop up until the LLM
-        request, then returns the raw request payload that would be sent to the LLM
-        provider. Useful for debugging and inspection.
-
-        Args:
-          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_name: The name of the designated message tool.
-
-          background: Whether to process the request in the background.
-
-          enable_thinking: If set to True, enables reasoning before responses or tool calls from the agent.
-
-          include_pings: Whether to include periodic keepalive ping messages in the stream to prevent
-              connection timeouts.
-
-          include_return_message_types: Only return specified message types in the response. If `None` (default) returns
-              all messages.
-
-          max_steps: Maximum number of steps the agent should take to process the request.
-
-          stream_tokens: Flag to determine if individual tokens should be streamed, rather than streaming
-              per step.
-
-          use_assistant_message: Whether the server should parse specific tool call arguments (default
-              `send_message`) as `AssistantMessage` objects.
-
-          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
-        """
-        ...
-
-    @required_args(["messages"])
-    def preview_raw_payload(
-        self,
-        agent_id: str,
-        *,
-        messages: Iterable[message_preview_raw_payload_params.LettaRequestMessage]
-        | Iterable[message_preview_raw_payload_params.LettaStreamingRequestMessage],
-        assistant_message_tool_kwarg: str | Omit = omit,
-        assistant_message_tool_name: str | Omit = omit,
-        enable_thinking: str | Omit = omit,
-        include_return_message_types: Optional[List[MessageType]] | Omit = omit,
-        max_steps: int | Omit = omit,
-        use_assistant_message: bool | Omit = omit,
-        background: bool | Omit = omit,
-        include_pings: bool | Omit = omit,
-        stream_tokens: bool | Omit = omit,
-        # 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,
-    ) -> MessagePreviewRawPayloadResponse:
         if not agent_id:
             raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return self._post(
-            f"/v1/agents/{agent_id}/messages/preview-raw-payload",
+        return self._patch(
+            f"/v1/agents/{agent_id}/reset-messages",
             body=maybe_transform(
-                {
-                    "messages": messages,
-                    "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
-                    "assistant_message_tool_name": assistant_message_tool_name,
-                    "enable_thinking": enable_thinking,
-                    "include_return_message_types": include_return_message_types,
-                    "max_steps": max_steps,
-                    "use_assistant_message": use_assistant_message,
-                    "background": background,
-                    "include_pings": include_pings,
-                    "stream_tokens": stream_tokens,
-                },
-                message_preview_raw_payload_params.MessagePreviewRawPayloadParams,
+                {"add_default_initial_messages": add_default_initial_messages}, message_reset_params.MessageResetParams
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MessagePreviewRawPayloadResponse,
-        )
-
-    def search(
-        self,
-        *,
-        end_date: Union[str, datetime, None] | Omit = omit,
-        limit: int | Omit = omit,
-        project_id: Optional[str] | Omit = omit,
-        query: Optional[str] | Omit = omit,
-        roles: Optional[List[MessageRole]] | Omit = omit,
-        search_mode: Literal["vector", "fts", "hybrid"] | Omit = omit,
-        start_date: Union[str, datetime, None] | Omit = omit,
-        template_id: Optional[str] | Omit = omit,
-        # 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,
-    ) -> MessageSearchResponse:
-        """
-        Search messages across the entire organization with optional project and
-        template filtering. Returns messages with FTS/vector ranks and total RRF score.
-
-        This is a cloud-only feature.
-
-        Args:
-          end_date: Filter messages created on or before this date
-
-          limit: Maximum number of results to return
-
-          project_id: Filter messages by project ID
-
-          query: Text query for full-text search
-
-          roles: Filter messages by role
-
-          search_mode: Search mode to use
-
-          start_date: Filter messages created after this date
-
-          template_id: Filter messages by template ID
-
-          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
-        """
-        return self._post(
-            "/v1/agents/messages/search",
-            body=maybe_transform(
-                {
-                    "end_date": end_date,
-                    "limit": limit,
-                    "project_id": project_id,
-                    "query": query,
-                    "roles": roles,
-                    "search_mode": search_mode,
-                    "start_date": start_date,
-                    "template_id": template_id,
-                },
-                message_search_params.MessageSearchParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=MessageSearchResponse,
+            cast_to=AgentState,
         )
 
     def send(
@@ -608,11 +443,15 @@ class MessagesResource(SyncAPIResource):
         message from a user and processes it through the agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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.
 
@@ -622,7 +461,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
 
@@ -679,15 +519,19 @@ class MessagesResource(SyncAPIResource):
         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.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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.
 
           callback_url: Optional callback URL to POST to when the job completes
 
@@ -699,7 +543,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
 
@@ -732,11 +577,11 @@ class MessagesResource(SyncAPIResource):
             cast_to=Run,
         )
 
-    def send_stream(
+    def stream(
         self,
         agent_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,
@@ -760,11 +605,15 @@ class MessagesResource(SyncAPIResource):
         of the response always, and stream the tokens if 'stream_tokens' is set to True.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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.
 
@@ -782,7 +631,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
 
@@ -809,7 +659,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
@@ -817,6 +667,42 @@ class MessagesResource(SyncAPIResource):
             cast_to=object,
         )
 
+    def summarize(
+        self,
+        agent_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,
+    ) -> None:
+        """
+        Summarize an agent's conversation history.
+
+        Args:
+          agent_id: The ID of the agent in the format 'agent-<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 agent_id:
+            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return self._post(
+            f"/v1/agents/{agent_id}/summarize",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class AsyncMessagesResource(AsyncAPIResource):
     @cached_property
@@ -857,6 +743,10 @@ class AsyncMessagesResource(AsyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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)
 
@@ -889,6 +779,10 @@ class AsyncMessagesResource(AsyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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)
 
@@ -921,6 +815,10 @@ class AsyncMessagesResource(AsyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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
@@ -950,6 +848,10 @@ class AsyncMessagesResource(AsyncAPIResource):
         Update the details of a message associated with an agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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)
 
@@ -1008,7 +910,7 @@ class AsyncMessagesResource(AsyncAPIResource):
             ),
         )
 
-    async def list(
+    def list(
         self,
         agent_id: str,
         *,
@@ -1018,7 +920,9 @@ class AsyncMessagesResource(AsyncAPIResource):
         before: Optional[str] | Omit = omit,
         group_id: Optional[str] | Omit = omit,
         include_err: Optional[bool] | Omit = omit,
-        limit: int | Omit = omit,
+        limit: Optional[int] | Omit = omit,
+        order: Literal["asc", "desc"] | Omit = omit,
+        order_by: Literal["created_at"] | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # 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.
@@ -1026,25 +930,34 @@ 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:
-          after: Message after which to retrieve the returned messages.
+          agent_id: The ID of the agent in the format 'agent-<uuid4>'
+
+          after: Message ID cursor for pagination. Returns messages that come after this message
+              ID in the specified sort order
 
           assistant_message_tool_kwarg: The name of the message argument.
 
           assistant_message_tool_name: The name of the designated message tool.
 
-          before: Message before which to retrieve the returned messages.
+          before: Message ID cursor for pagination. Returns messages that come before this message
+              ID in the specified sort order
 
           group_id: Group ID to filter messages by.
 
           include_err: Whether to include error messages and error statuses. For debugging purposes
               only.
 
-          limit: Maximum number of messages to retrieve.
+          limit: Maximum number of messages to return
+
+          order: Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
+              newest first
+
+          order_by: Field to sort by
 
           use_assistant_message: Whether to use assistant messages
 
@@ -1058,14 +971,15 @@ class AsyncMessagesResource(AsyncAPIResource):
         """
         if not agent_id:
             raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return await self._get(
+        return self._get_api_list(
             f"/v1/agents/{agent_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,
@@ -1074,12 +988,14 @@ class AsyncMessagesResource(AsyncAPIResource):
                         "group_id": group_id,
                         "include_err": include_err,
                         "limit": limit,
+                        "order": order,
+                        "order_by": order_by,
                         "use_assistant_message": use_assistant_message,
                     },
                     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 cancel(
@@ -1102,6 +1018,8 @@ class AsyncMessagesResource(AsyncAPIResource):
         Note to cancel active runs associated with an agent, redis is required.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<uuid4>'
+
           run_ids: Optional list of run IDs to cancel
 
           extra_headers: Send extra headers
@@ -1123,48 +1041,25 @@ class AsyncMessagesResource(AsyncAPIResource):
             cast_to=MessageCancelResponse,
         )
 
-    @overload
-    async def preview_raw_payload(
+    async def reset(
         self,
         agent_id: str,
         *,
-        messages: Iterable[message_preview_raw_payload_params.LettaRequestMessage],
-        assistant_message_tool_kwarg: str | Omit = omit,
-        assistant_message_tool_name: str | Omit = omit,
-        enable_thinking: str | Omit = omit,
-        include_return_message_types: Optional[List[MessageType]] | Omit = omit,
-        max_steps: int | Omit = omit,
-        use_assistant_message: bool | Omit = omit,
+        add_default_initial_messages: bool | Omit = omit,
         # 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,
-    ) -> MessagePreviewRawPayloadResponse:
+    ) -> AgentState:
         """
-        Inspect the raw LLM request payload without sending it.
-
-        This endpoint processes the message through the agent loop up until the LLM
-        request, then returns the raw request payload that would be sent to the LLM
-        provider. Useful for debugging and inspection.
+        Resets the messages for an agent
 
         Args:
-          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_name: The name of the designated message tool.
-
-          enable_thinking: If set to True, enables reasoning before responses or tool calls from the agent.
-
-          include_return_message_types: Only return specified message types in the response. If `None` (default) returns
-              all messages.
-
-          max_steps: Maximum number of steps the agent should take to process the request.
+          agent_id: The ID of the agent in the format 'agent-<uuid4>'
 
-          use_assistant_message: Whether the server should parse specific tool call arguments (default
-              `send_message`) as `AssistantMessage` objects.
+          add_default_initial_messages: If true, adds the default initial messages after resetting.
 
           extra_headers: Send extra headers
 
@@ -1174,188 +1069,17 @@ class AsyncMessagesResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        ...
-
-    @overload
-    async def preview_raw_payload(
-        self,
-        agent_id: str,
-        *,
-        messages: Iterable[message_preview_raw_payload_params.LettaStreamingRequestMessage],
-        assistant_message_tool_kwarg: str | Omit = omit,
-        assistant_message_tool_name: str | Omit = omit,
-        background: bool | Omit = omit,
-        enable_thinking: str | Omit = omit,
-        include_pings: bool | Omit = omit,
-        include_return_message_types: Optional[List[MessageType]] | Omit = omit,
-        max_steps: int | Omit = omit,
-        stream_tokens: bool | Omit = omit,
-        use_assistant_message: bool | Omit = omit,
-        # 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,
-    ) -> MessagePreviewRawPayloadResponse:
-        """
-        Inspect the raw LLM request payload without sending it.
-
-        This endpoint processes the message through the agent loop up until the LLM
-        request, then returns the raw request payload that would be sent to the LLM
-        provider. Useful for debugging and inspection.
-
-        Args:
-          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_name: The name of the designated message tool.
-
-          background: Whether to process the request in the background.
-
-          enable_thinking: If set to True, enables reasoning before responses or tool calls from the agent.
-
-          include_pings: Whether to include periodic keepalive ping messages in the stream to prevent
-              connection timeouts.
-
-          include_return_message_types: Only return specified message types in the response. If `None` (default) returns
-              all messages.
-
-          max_steps: Maximum number of steps the agent should take to process the request.
-
-          stream_tokens: Flag to determine if individual tokens should be streamed, rather than streaming
-              per step.
-
-          use_assistant_message: Whether the server should parse specific tool call arguments (default
-              `send_message`) as `AssistantMessage` objects.
-
-          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
-        """
-        ...
-
-    @required_args(["messages"])
-    async def preview_raw_payload(
-        self,
-        agent_id: str,
-        *,
-        messages: Iterable[message_preview_raw_payload_params.LettaRequestMessage]
-        | Iterable[message_preview_raw_payload_params.LettaStreamingRequestMessage],
-        assistant_message_tool_kwarg: str | Omit = omit,
-        assistant_message_tool_name: str | Omit = omit,
-        enable_thinking: str | Omit = omit,
-        include_return_message_types: Optional[List[MessageType]] | Omit = omit,
-        max_steps: int | Omit = omit,
-        use_assistant_message: bool | Omit = omit,
-        background: bool | Omit = omit,
-        include_pings: bool | Omit = omit,
-        stream_tokens: bool | Omit = omit,
-        # 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,
-    ) -> MessagePreviewRawPayloadResponse:
         if not agent_id:
             raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return await self._post(
-            f"/v1/agents/{agent_id}/messages/preview-raw-payload",
+        return await self._patch(
+            f"/v1/agents/{agent_id}/reset-messages",
             body=await async_maybe_transform(
-                {
-                    "messages": messages,
-                    "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
-                    "assistant_message_tool_name": assistant_message_tool_name,
-                    "enable_thinking": enable_thinking,
-                    "include_return_message_types": include_return_message_types,
-                    "max_steps": max_steps,
-                    "use_assistant_message": use_assistant_message,
-                    "background": background,
-                    "include_pings": include_pings,
-                    "stream_tokens": stream_tokens,
-                },
-                message_preview_raw_payload_params.MessagePreviewRawPayloadParams,
+                {"add_default_initial_messages": add_default_initial_messages}, message_reset_params.MessageResetParams
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=MessagePreviewRawPayloadResponse,
-        )
-
-    async def search(
-        self,
-        *,
-        end_date: Union[str, datetime, None] | Omit = omit,
-        limit: int | Omit = omit,
-        project_id: Optional[str] | Omit = omit,
-        query: Optional[str] | Omit = omit,
-        roles: Optional[List[MessageRole]] | Omit = omit,
-        search_mode: Literal["vector", "fts", "hybrid"] | Omit = omit,
-        start_date: Union[str, datetime, None] | Omit = omit,
-        template_id: Optional[str] | Omit = omit,
-        # 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,
-    ) -> MessageSearchResponse:
-        """
-        Search messages across the entire organization with optional project and
-        template filtering. Returns messages with FTS/vector ranks and total RRF score.
-
-        This is a cloud-only feature.
-
-        Args:
-          end_date: Filter messages created on or before this date
-
-          limit: Maximum number of results to return
-
-          project_id: Filter messages by project ID
-
-          query: Text query for full-text search
-
-          roles: Filter messages by role
-
-          search_mode: Search mode to use
-
-          start_date: Filter messages created after this date
-
-          template_id: Filter messages by template ID
-
-          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
-        """
-        return await self._post(
-            "/v1/agents/messages/search",
-            body=await async_maybe_transform(
-                {
-                    "end_date": end_date,
-                    "limit": limit,
-                    "project_id": project_id,
-                    "query": query,
-                    "roles": roles,
-                    "search_mode": search_mode,
-                    "start_date": start_date,
-                    "template_id": template_id,
-                },
-                message_search_params.MessageSearchParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=MessageSearchResponse,
+            cast_to=AgentState,
         )
 
     async def send(
@@ -1382,11 +1106,15 @@ class AsyncMessagesResource(AsyncAPIResource):
         message from a user and processes it through the agent.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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.
 
@@ -1396,7 +1124,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
 
@@ -1453,15 +1182,19 @@ class AsyncMessagesResource(AsyncAPIResource):
         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.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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.
 
           callback_url: Optional callback URL to POST to when the job completes
 
@@ -1473,7 +1206,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
 
@@ -1506,11 +1240,11 @@ class AsyncMessagesResource(AsyncAPIResource):
             cast_to=Run,
         )
 
-    async def send_stream(
+    async def stream(
         self,
         agent_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,
@@ -1534,11 +1268,15 @@ class AsyncMessagesResource(AsyncAPIResource):
         of the response always, and stream the tokens if 'stream_tokens' is set to True.
 
         Args:
+          agent_id: The ID of the agent in the format 'agent-<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.
 
@@ -1556,7 +1294,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
 
@@ -1583,7 +1322,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
@@ -1591,6 +1330,42 @@ class AsyncMessagesResource(AsyncAPIResource):
             cast_to=object,
         )
 
+    async def summarize(
+        self,
+        agent_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,
+    ) -> None:
+        """
+        Summarize an agent's conversation history.
+
+        Args:
+          agent_id: The ID of the agent in the format 'agent-<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 agent_id:
+            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._post(
+            f"/v1/agents/{agent_id}/summarize",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
 
 class MessagesResourceWithRawResponse:
     def __init__(self, messages: MessagesResource) -> None:
@@ -1605,11 +1380,8 @@ class MessagesResourceWithRawResponse:
         self.cancel = to_raw_response_wrapper(
             messages.cancel,
         )
-        self.preview_raw_payload = to_raw_response_wrapper(
-            messages.preview_raw_payload,
-        )
-        self.search = to_raw_response_wrapper(
-            messages.search,
+        self.reset = to_raw_response_wrapper(
+            messages.reset,
         )
         self.send = to_raw_response_wrapper(
             messages.send,
@@ -1617,8 +1389,11 @@ class MessagesResourceWithRawResponse:
         self.send_async = to_raw_response_wrapper(
             messages.send_async,
         )
-        self.send_stream = to_raw_response_wrapper(
-            messages.send_stream,
+        self.stream = to_raw_response_wrapper(
+            messages.stream,
+        )
+        self.summarize = to_raw_response_wrapper(
+            messages.summarize,
         )
 
 
@@ -1635,11 +1410,8 @@ class AsyncMessagesResourceWithRawResponse:
         self.cancel = async_to_raw_response_wrapper(
             messages.cancel,
         )
-        self.preview_raw_payload = async_to_raw_response_wrapper(
-            messages.preview_raw_payload,
-        )
-        self.search = async_to_raw_response_wrapper(
-            messages.search,
+        self.reset = async_to_raw_response_wrapper(
+            messages.reset,
         )
         self.send = async_to_raw_response_wrapper(
             messages.send,
@@ -1647,8 +1419,11 @@ class AsyncMessagesResourceWithRawResponse:
         self.send_async = async_to_raw_response_wrapper(
             messages.send_async,
         )
-        self.send_stream = async_to_raw_response_wrapper(
-            messages.send_stream,
+        self.stream = async_to_raw_response_wrapper(
+            messages.stream,
+        )
+        self.summarize = async_to_raw_response_wrapper(
+            messages.summarize,
         )
 
 
@@ -1665,11 +1440,8 @@ class MessagesResourceWithStreamingResponse:
         self.cancel = to_streamed_response_wrapper(
             messages.cancel,
         )
-        self.preview_raw_payload = to_streamed_response_wrapper(
-            messages.preview_raw_payload,
-        )
-        self.search = to_streamed_response_wrapper(
-            messages.search,
+        self.reset = to_streamed_response_wrapper(
+            messages.reset,
         )
         self.send = to_streamed_response_wrapper(
             messages.send,
@@ -1677,8 +1449,11 @@ class MessagesResourceWithStreamingResponse:
         self.send_async = to_streamed_response_wrapper(
             messages.send_async,
         )
-        self.send_stream = to_streamed_response_wrapper(
-            messages.send_stream,
+        self.stream = to_streamed_response_wrapper(
+            messages.stream,
+        )
+        self.summarize = to_streamed_response_wrapper(
+            messages.summarize,
         )
 
 
@@ -1695,11 +1470,8 @@ class AsyncMessagesResourceWithStreamingResponse:
         self.cancel = async_to_streamed_response_wrapper(
             messages.cancel,
         )
-        self.preview_raw_payload = async_to_streamed_response_wrapper(
-            messages.preview_raw_payload,
-        )
-        self.search = async_to_streamed_response_wrapper(
-            messages.search,
+        self.reset = async_to_streamed_response_wrapper(
+            messages.reset,
         )
         self.send = async_to_streamed_response_wrapper(
             messages.send,
@@ -1707,6 +1479,9 @@ class AsyncMessagesResourceWithStreamingResponse:
         self.send_async = async_to_streamed_response_wrapper(
             messages.send_async,
         )
-        self.send_stream = async_to_streamed_response_wrapper(
-            messages.send_stream,
+        self.stream = async_to_streamed_response_wrapper(
+            messages.stream,
+        )
+        self.summarize = async_to_streamed_response_wrapper(
+            messages.summarize,
         )