letta-client 1.0.0a5__py3-none-any.whl → 1.0.0a7__py3-none-any.whl

letta_client/agents/messages/client.py

@@ -1,1514 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import datetime as dt
-import typing
-
-from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
-from ...core.request_options import RequestOptions
-from ...types.agent_state import AgentState
-from ...types.letta_message_union import LettaMessageUnion
-from ...types.letta_request_messages_item import LettaRequestMessagesItem
-from ...types.letta_response import LettaResponse
-from ...types.letta_streaming_request_messages_item import LettaStreamingRequestMessagesItem
-from ...types.message_role import MessageRole
-from ...types.message_search_result import MessageSearchResult
-from ...types.message_type import MessageType
-from ...types.run import Run
-from .raw_client import AsyncRawMessagesClient, RawMessagesClient
-from .types.letta_async_request_messages_item import LettaAsyncRequestMessagesItem
-from .types.letta_streaming_response import LettaStreamingResponse
-from .types.message_search_request_search_mode import MessageSearchRequestSearchMode
-from .types.messages_list_request_order import MessagesListRequestOrder
-from .types.messages_modify_request import MessagesModifyRequest
-from .types.messages_modify_response import MessagesModifyResponse
-from .types.messages_preview_request import MessagesPreviewRequest
-
-# this is used as the default value for optional parameters
-OMIT = typing.cast(typing.Any, ...)
-
-
-class MessagesClient:
-    def __init__(self, *, client_wrapper: SyncClientWrapper):
-        self._raw_client = RawMessagesClient(client_wrapper=client_wrapper)
-
-    @property
-    def with_raw_response(self) -> RawMessagesClient:
-        """
-        Retrieves a raw implementation of this client that returns raw responses.
-
-        Returns
-        -------
-        RawMessagesClient
-        """
-        return self._raw_client
-
-    def list(
-        self,
-        agent_id: str,
-        *,
-        before: typing.Optional[str] = None,
-        after: typing.Optional[str] = None,
-        limit: typing.Optional[int] = None,
-        order: typing.Optional[MessagesListRequestOrder] = None,
-        order_by: typing.Optional[typing.Literal["created_at"]] = None,
-        group_id: typing.Optional[str] = None,
-        use_assistant_message: typing.Optional[bool] = None,
-        assistant_message_tool_name: typing.Optional[str] = None,
-        assistant_message_tool_kwarg: typing.Optional[str] = None,
-        include_err: typing.Optional[bool] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.List[LettaMessageUnion]:
-        """
-        Retrieve message history for an agent.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        before : typing.Optional[str]
-            Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
-
-        after : typing.Optional[str]
-            Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order
-
-        limit : typing.Optional[int]
-            Maximum number of messages to return
-
-        order : typing.Optional[MessagesListRequestOrder]
-            Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
-
-        order_by : typing.Optional[typing.Literal["created_at"]]
-            Field to sort by
-
-        group_id : typing.Optional[str]
-            Group ID to filter messages by.
-
-        use_assistant_message : typing.Optional[bool]
-            Whether to use assistant messages
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument.
-
-        include_err : typing.Optional[bool]
-            Whether to include error messages and error statuses. For debugging purposes only.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.List[LettaMessageUnion]
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.agents.messages.list(
-            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-            before="before",
-            after="after",
-            limit=1,
-            order="asc",
-            group_id="group_id",
-            use_assistant_message=True,
-            assistant_message_tool_name="assistant_message_tool_name",
-            assistant_message_tool_kwarg="assistant_message_tool_kwarg",
-            include_err=True,
-        )
-        """
-        _response = self._raw_client.list(
-            agent_id,
-            before=before,
-            after=after,
-            limit=limit,
-            order=order,
-            order_by=order_by,
-            group_id=group_id,
-            use_assistant_message=use_assistant_message,
-            assistant_message_tool_name=assistant_message_tool_name,
-            assistant_message_tool_kwarg=assistant_message_tool_kwarg,
-            include_err=include_err,
-            request_options=request_options,
-        )
-        return _response.data
-
-    def create(
-        self,
-        agent_id: str,
-        *,
-        messages: typing.Sequence[LettaRequestMessagesItem],
-        max_steps: typing.Optional[int] = OMIT,
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
-        include_return_message_types: typing.Optional[typing.Sequence[MessageType]] = OMIT,
-        enable_thinking: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> LettaResponse:
-        """
-        Process a user message and return the agent's response.
-        This endpoint accepts a message from a user and processes it through the agent.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        messages : typing.Sequence[LettaRequestMessagesItem]
-            The messages to be sent to the agent.
-
-        max_steps : typing.Optional[int]
-            Maximum number of steps the agent should take to process the request.
-
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
-
-        include_return_message_types : typing.Optional[typing.Sequence[MessageType]]
-            Only return specified message types in the response. If `None` (default) returns all messages.
-
-        enable_thinking : typing.Optional[str]
-            If set to True, enables reasoning before responses or tool calls from the agent.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        LettaResponse
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta, MessageCreate, TextContent
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.agents.messages.create(
-            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-            messages=[
-                MessageCreate(
-                    role="user",
-                    content=[
-                        TextContent(
-                            text="The sky above the port was the color of television, tuned to a dead channel.",
-                        )
-                    ],
-                )
-            ],
-        )
-        """
-        _response = self._raw_client.create(
-            agent_id,
-            messages=messages,
-            max_steps=max_steps,
-            use_assistant_message=use_assistant_message,
-            assistant_message_tool_name=assistant_message_tool_name,
-            assistant_message_tool_kwarg=assistant_message_tool_kwarg,
-            include_return_message_types=include_return_message_types,
-            enable_thinking=enable_thinking,
-            request_options=request_options,
-        )
-        return _response.data
-
-    def modify(
-        self,
-        agent_id: str,
-        message_id: str,
-        *,
-        request: MessagesModifyRequest,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> MessagesModifyResponse:
-        """
-        Update the details of a message associated with an agent.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        message_id : str
-            The ID of the message in the format 'message-<uuid4>'
-
-        request : MessagesModifyRequest
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        MessagesModifyResponse
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta, UpdateSystemMessage
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.agents.messages.modify(
-            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-            message_id="message-123e4567-e89b-42d3-8456-426614174000",
-            request=UpdateSystemMessage(
-                content="content",
-            ),
-        )
-        """
-        _response = self._raw_client.modify(agent_id, message_id, request=request, request_options=request_options)
-        return _response.data
-
-    def create_stream(
-        self,
-        agent_id: str,
-        *,
-        messages: typing.Sequence[LettaStreamingRequestMessagesItem],
-        max_steps: typing.Optional[int] = OMIT,
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
-        include_return_message_types: typing.Optional[typing.Sequence[MessageType]] = OMIT,
-        enable_thinking: typing.Optional[str] = OMIT,
-        stream_tokens: typing.Optional[bool] = OMIT,
-        include_pings: typing.Optional[bool] = OMIT,
-        background: typing.Optional[bool] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.Iterator[LettaStreamingResponse]:
-        """
-        Process a user message and return the agent's response.
-        This endpoint accepts a message from a user and processes it through the agent.
-        It will stream the steps of the response always, and stream the tokens if 'stream_tokens' is set to True.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        messages : typing.Sequence[LettaStreamingRequestMessagesItem]
-            The messages to be sent to the agent.
-
-        max_steps : typing.Optional[int]
-            Maximum number of steps the agent should take to process the request.
-
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
-
-        include_return_message_types : typing.Optional[typing.Sequence[MessageType]]
-            Only return specified message types in the response. If `None` (default) returns all messages.
-
-        enable_thinking : typing.Optional[str]
-            If set to True, enables reasoning before responses or tool calls from the agent.
-
-        stream_tokens : typing.Optional[bool]
-            Flag to determine if individual tokens should be streamed, rather than streaming per step.
-
-        include_pings : typing.Optional[bool]
-            Whether to include periodic keepalive ping messages in the stream to prevent connection timeouts.
-
-        background : typing.Optional[bool]
-            Whether to process the request in the background.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Yields
-        ------
-        typing.Iterator[LettaStreamingResponse]
-            Successful response
-
-        Examples
-        --------
-        from letta_client import Letta, MessageCreate, TextContent
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        response = client.agents.messages.create_stream(
-            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-            messages=[
-                MessageCreate(
-                    role="user",
-                    content=[
-                        TextContent(
-                            text="The sky above the port was the color of television, tuned to a dead channel.",
-                        )
-                    ],
-                )
-            ],
-        )
-        for chunk in response:
-            yield chunk
-        """
-        with self._raw_client.create_stream(
-            agent_id,
-            messages=messages,
-            max_steps=max_steps,
-            use_assistant_message=use_assistant_message,
-            assistant_message_tool_name=assistant_message_tool_name,
-            assistant_message_tool_kwarg=assistant_message_tool_kwarg,
-            include_return_message_types=include_return_message_types,
-            enable_thinking=enable_thinking,
-            stream_tokens=stream_tokens,
-            include_pings=include_pings,
-            background=background,
-            request_options=request_options,
-        ) as r:
-            yield from r.data
-
-    def cancel(
-        self,
-        agent_id: str,
-        *,
-        run_ids: typing.Optional[typing.Sequence[str]] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.Dict[str, typing.Optional[typing.Any]]:
-        """
-        Cancel runs associated with an agent. If run_ids are passed in, cancel those in particular.
-
-        Note to cancel active runs associated with an agent, redis is required.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        run_ids : typing.Optional[typing.Sequence[str]]
-            Optional list of run IDs to cancel
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.Dict[str, typing.Optional[typing.Any]]
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.agents.messages.cancel(
-            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-        )
-        """
-        _response = self._raw_client.cancel(agent_id, run_ids=run_ids, request_options=request_options)
-        return _response.data
-
-    def search(
-        self,
-        *,
-        query: typing.Optional[str] = OMIT,
-        search_mode: typing.Optional[MessageSearchRequestSearchMode] = OMIT,
-        roles: typing.Optional[typing.Sequence[MessageRole]] = OMIT,
-        project_id: typing.Optional[str] = OMIT,
-        template_id: typing.Optional[str] = OMIT,
-        limit: typing.Optional[int] = OMIT,
-        start_date: typing.Optional[dt.datetime] = OMIT,
-        end_date: typing.Optional[dt.datetime] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.List[MessageSearchResult]:
-        """
-        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.
-
-        Parameters
-        ----------
-        query : typing.Optional[str]
-            Text query for full-text search
-
-        search_mode : typing.Optional[MessageSearchRequestSearchMode]
-            Search mode to use
-
-        roles : typing.Optional[typing.Sequence[MessageRole]]
-            Filter messages by role
-
-        project_id : typing.Optional[str]
-            Filter messages by project ID
-
-        template_id : typing.Optional[str]
-            Filter messages by template ID
-
-        limit : typing.Optional[int]
-            Maximum number of results to return
-
-        start_date : typing.Optional[dt.datetime]
-            Filter messages created after this date
-
-        end_date : typing.Optional[dt.datetime]
-            Filter messages created on or before this date
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.List[MessageSearchResult]
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.agents.messages.search()
-        """
-        _response = self._raw_client.search(
-            query=query,
-            search_mode=search_mode,
-            roles=roles,
-            project_id=project_id,
-            template_id=template_id,
-            limit=limit,
-            start_date=start_date,
-            end_date=end_date,
-            request_options=request_options,
-        )
-        return _response.data
-
-    def create_async(
-        self,
-        agent_id: str,
-        *,
-        messages: typing.Sequence[LettaAsyncRequestMessagesItem],
-        max_steps: typing.Optional[int] = OMIT,
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
-        include_return_message_types: typing.Optional[typing.Sequence[MessageType]] = OMIT,
-        enable_thinking: typing.Optional[str] = OMIT,
-        callback_url: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> Run:
-        """
-        Asynchronously process a user message and return a run object.
-        The actual processing happens in the background, and the status can be checked using the run ID.
-
-        This is "asynchronous" in the sense that it's a background run and explicitly must be fetched by the run ID.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        messages : typing.Sequence[LettaAsyncRequestMessagesItem]
-            The messages to be sent to the agent.
-
-        max_steps : typing.Optional[int]
-            Maximum number of steps the agent should take to process the request.
-
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
-
-        include_return_message_types : typing.Optional[typing.Sequence[MessageType]]
-            Only return specified message types in the response. If `None` (default) returns all messages.
-
-        enable_thinking : typing.Optional[str]
-            If set to True, enables reasoning before responses or tool calls from the agent.
-
-        callback_url : typing.Optional[str]
-            Optional callback URL to POST to when the job completes
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        Run
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta, MessageCreate, TextContent
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.agents.messages.create_async(
-            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-            messages=[
-                MessageCreate(
-                    role="user",
-                    content=[
-                        TextContent(
-                            text="text",
-                        )
-                    ],
-                )
-            ],
-        )
-        """
-        _response = self._raw_client.create_async(
-            agent_id,
-            messages=messages,
-            max_steps=max_steps,
-            use_assistant_message=use_assistant_message,
-            assistant_message_tool_name=assistant_message_tool_name,
-            assistant_message_tool_kwarg=assistant_message_tool_kwarg,
-            include_return_message_types=include_return_message_types,
-            enable_thinking=enable_thinking,
-            callback_url=callback_url,
-            request_options=request_options,
-        )
-        return _response.data
-
-    def reset(
-        self,
-        agent_id: str,
-        *,
-        add_default_initial_messages: typing.Optional[bool] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> AgentState:
-        """
-        Resets the messages for an agent
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        add_default_initial_messages : typing.Optional[bool]
-            If true, adds the default initial messages after resetting.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        AgentState
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.agents.messages.reset(
-            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-            add_default_initial_messages=True,
-        )
-        """
-        _response = self._raw_client.reset(
-            agent_id, add_default_initial_messages=add_default_initial_messages, request_options=request_options
-        )
-        return _response.data
-
-    def preview(
-        self, agent_id: str, *, request: MessagesPreviewRequest, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Dict[str, typing.Optional[typing.Any]]:
-        """
-        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.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        request : MessagesPreviewRequest
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.Dict[str, typing.Optional[typing.Any]]
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta, LettaRequest, MessageCreate, TextContent
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.agents.messages.preview(
-            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-            request=LettaRequest(
-                messages=[
-                    MessageCreate(
-                        role="user",
-                        content=[
-                            TextContent(
-                                text="text",
-                            )
-                        ],
-                    )
-                ],
-            ),
-        )
-        """
-        _response = self._raw_client.preview(agent_id, request=request, request_options=request_options)
-        return _response.data
-
-    def summarize(
-        self, agent_id: str, *, max_message_length: int, request_options: typing.Optional[RequestOptions] = None
-    ) -> None:
-        """
-        Summarize an agent's conversation history to a target message length.
-
-        This endpoint summarizes the current message history for a given agent,
-        truncating and compressing it down to the specified `max_message_length`.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        max_message_length : int
-            Maximum number of messages to retain after summarization.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.agents.messages.summarize(
-            agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-            max_message_length=1,
-        )
-        """
-        _response = self._raw_client.summarize(
-            agent_id, max_message_length=max_message_length, request_options=request_options
-        )
-        return _response.data
-
-
-class AsyncMessagesClient:
-    def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._raw_client = AsyncRawMessagesClient(client_wrapper=client_wrapper)
-
-    @property
-    def with_raw_response(self) -> AsyncRawMessagesClient:
-        """
-        Retrieves a raw implementation of this client that returns raw responses.
-
-        Returns
-        -------
-        AsyncRawMessagesClient
-        """
-        return self._raw_client
-
-    async def list(
-        self,
-        agent_id: str,
-        *,
-        before: typing.Optional[str] = None,
-        after: typing.Optional[str] = None,
-        limit: typing.Optional[int] = None,
-        order: typing.Optional[MessagesListRequestOrder] = None,
-        order_by: typing.Optional[typing.Literal["created_at"]] = None,
-        group_id: typing.Optional[str] = None,
-        use_assistant_message: typing.Optional[bool] = None,
-        assistant_message_tool_name: typing.Optional[str] = None,
-        assistant_message_tool_kwarg: typing.Optional[str] = None,
-        include_err: typing.Optional[bool] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.List[LettaMessageUnion]:
-        """
-        Retrieve message history for an agent.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        before : typing.Optional[str]
-            Message ID cursor for pagination. Returns messages that come before this message ID in the specified sort order
-
-        after : typing.Optional[str]
-            Message ID cursor for pagination. Returns messages that come after this message ID in the specified sort order
-
-        limit : typing.Optional[int]
-            Maximum number of messages to return
-
-        order : typing.Optional[MessagesListRequestOrder]
-            Sort order for messages by creation time. 'asc' for oldest first, 'desc' for newest first
-
-        order_by : typing.Optional[typing.Literal["created_at"]]
-            Field to sort by
-
-        group_id : typing.Optional[str]
-            Group ID to filter messages by.
-
-        use_assistant_message : typing.Optional[bool]
-            Whether to use assistant messages
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument.
-
-        include_err : typing.Optional[bool]
-            Whether to include error messages and error statuses. For debugging purposes only.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.List[LettaMessageUnion]
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.messages.list(
-                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-                before="before",
-                after="after",
-                limit=1,
-                order="asc",
-                group_id="group_id",
-                use_assistant_message=True,
-                assistant_message_tool_name="assistant_message_tool_name",
-                assistant_message_tool_kwarg="assistant_message_tool_kwarg",
-                include_err=True,
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.list(
-            agent_id,
-            before=before,
-            after=after,
-            limit=limit,
-            order=order,
-            order_by=order_by,
-            group_id=group_id,
-            use_assistant_message=use_assistant_message,
-            assistant_message_tool_name=assistant_message_tool_name,
-            assistant_message_tool_kwarg=assistant_message_tool_kwarg,
-            include_err=include_err,
-            request_options=request_options,
-        )
-        return _response.data
-
-    async def create(
-        self,
-        agent_id: str,
-        *,
-        messages: typing.Sequence[LettaRequestMessagesItem],
-        max_steps: typing.Optional[int] = OMIT,
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
-        include_return_message_types: typing.Optional[typing.Sequence[MessageType]] = OMIT,
-        enable_thinking: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> LettaResponse:
-        """
-        Process a user message and return the agent's response.
-        This endpoint accepts a message from a user and processes it through the agent.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        messages : typing.Sequence[LettaRequestMessagesItem]
-            The messages to be sent to the agent.
-
-        max_steps : typing.Optional[int]
-            Maximum number of steps the agent should take to process the request.
-
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
-
-        include_return_message_types : typing.Optional[typing.Sequence[MessageType]]
-            Only return specified message types in the response. If `None` (default) returns all messages.
-
-        enable_thinking : typing.Optional[str]
-            If set to True, enables reasoning before responses or tool calls from the agent.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        LettaResponse
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta, MessageCreate, TextContent
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.messages.create(
-                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-                messages=[
-                    MessageCreate(
-                        role="user",
-                        content=[
-                            TextContent(
-                                text="The sky above the port was the color of television, tuned to a dead channel.",
-                            )
-                        ],
-                    )
-                ],
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.create(
-            agent_id,
-            messages=messages,
-            max_steps=max_steps,
-            use_assistant_message=use_assistant_message,
-            assistant_message_tool_name=assistant_message_tool_name,
-            assistant_message_tool_kwarg=assistant_message_tool_kwarg,
-            include_return_message_types=include_return_message_types,
-            enable_thinking=enable_thinking,
-            request_options=request_options,
-        )
-        return _response.data
-
-    async def modify(
-        self,
-        agent_id: str,
-        message_id: str,
-        *,
-        request: MessagesModifyRequest,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> MessagesModifyResponse:
-        """
-        Update the details of a message associated with an agent.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        message_id : str
-            The ID of the message in the format 'message-<uuid4>'
-
-        request : MessagesModifyRequest
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        MessagesModifyResponse
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta, UpdateSystemMessage
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.messages.modify(
-                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-                message_id="message-123e4567-e89b-42d3-8456-426614174000",
-                request=UpdateSystemMessage(
-                    content="content",
-                ),
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.modify(
-            agent_id, message_id, request=request, request_options=request_options
-        )
-        return _response.data
-
-    async def create_stream(
-        self,
-        agent_id: str,
-        *,
-        messages: typing.Sequence[LettaStreamingRequestMessagesItem],
-        max_steps: typing.Optional[int] = OMIT,
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
-        include_return_message_types: typing.Optional[typing.Sequence[MessageType]] = OMIT,
-        enable_thinking: typing.Optional[str] = OMIT,
-        stream_tokens: typing.Optional[bool] = OMIT,
-        include_pings: typing.Optional[bool] = OMIT,
-        background: typing.Optional[bool] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.AsyncIterator[LettaStreamingResponse]:
-        """
-        Process a user message and return the agent's response.
-        This endpoint accepts a message from a user and processes it through the agent.
-        It will stream the steps of the response always, and stream the tokens if 'stream_tokens' is set to True.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        messages : typing.Sequence[LettaStreamingRequestMessagesItem]
-            The messages to be sent to the agent.
-
-        max_steps : typing.Optional[int]
-            Maximum number of steps the agent should take to process the request.
-
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
-
-        include_return_message_types : typing.Optional[typing.Sequence[MessageType]]
-            Only return specified message types in the response. If `None` (default) returns all messages.
-
-        enable_thinking : typing.Optional[str]
-            If set to True, enables reasoning before responses or tool calls from the agent.
-
-        stream_tokens : typing.Optional[bool]
-            Flag to determine if individual tokens should be streamed, rather than streaming per step.
-
-        include_pings : typing.Optional[bool]
-            Whether to include periodic keepalive ping messages in the stream to prevent connection timeouts.
-
-        background : typing.Optional[bool]
-            Whether to process the request in the background.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Yields
-        ------
-        typing.AsyncIterator[LettaStreamingResponse]
-            Successful response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta, MessageCreate, TextContent
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            response = await client.agents.messages.create_stream(
-                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-                messages=[
-                    MessageCreate(
-                        role="user",
-                        content=[
-                            TextContent(
-                                text="The sky above the port was the color of television, tuned to a dead channel.",
-                            )
-                        ],
-                    )
-                ],
-            )
-            async for chunk in response:
-                yield chunk
-
-
-        asyncio.run(main())
-        """
-        async with self._raw_client.create_stream(
-            agent_id,
-            messages=messages,
-            max_steps=max_steps,
-            use_assistant_message=use_assistant_message,
-            assistant_message_tool_name=assistant_message_tool_name,
-            assistant_message_tool_kwarg=assistant_message_tool_kwarg,
-            include_return_message_types=include_return_message_types,
-            enable_thinking=enable_thinking,
-            stream_tokens=stream_tokens,
-            include_pings=include_pings,
-            background=background,
-            request_options=request_options,
-        ) as r:
-            async for _chunk in r.data:
-                yield _chunk
-
-    async def cancel(
-        self,
-        agent_id: str,
-        *,
-        run_ids: typing.Optional[typing.Sequence[str]] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.Dict[str, typing.Optional[typing.Any]]:
-        """
-        Cancel runs associated with an agent. If run_ids are passed in, cancel those in particular.
-
-        Note to cancel active runs associated with an agent, redis is required.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        run_ids : typing.Optional[typing.Sequence[str]]
-            Optional list of run IDs to cancel
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.Dict[str, typing.Optional[typing.Any]]
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.messages.cancel(
-                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.cancel(agent_id, run_ids=run_ids, request_options=request_options)
-        return _response.data
-
-    async def search(
-        self,
-        *,
-        query: typing.Optional[str] = OMIT,
-        search_mode: typing.Optional[MessageSearchRequestSearchMode] = OMIT,
-        roles: typing.Optional[typing.Sequence[MessageRole]] = OMIT,
-        project_id: typing.Optional[str] = OMIT,
-        template_id: typing.Optional[str] = OMIT,
-        limit: typing.Optional[int] = OMIT,
-        start_date: typing.Optional[dt.datetime] = OMIT,
-        end_date: typing.Optional[dt.datetime] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.List[MessageSearchResult]:
-        """
-        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.
-
-        Parameters
-        ----------
-        query : typing.Optional[str]
-            Text query for full-text search
-
-        search_mode : typing.Optional[MessageSearchRequestSearchMode]
-            Search mode to use
-
-        roles : typing.Optional[typing.Sequence[MessageRole]]
-            Filter messages by role
-
-        project_id : typing.Optional[str]
-            Filter messages by project ID
-
-        template_id : typing.Optional[str]
-            Filter messages by template ID
-
-        limit : typing.Optional[int]
-            Maximum number of results to return
-
-        start_date : typing.Optional[dt.datetime]
-            Filter messages created after this date
-
-        end_date : typing.Optional[dt.datetime]
-            Filter messages created on or before this date
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.List[MessageSearchResult]
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.messages.search()
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.search(
-            query=query,
-            search_mode=search_mode,
-            roles=roles,
-            project_id=project_id,
-            template_id=template_id,
-            limit=limit,
-            start_date=start_date,
-            end_date=end_date,
-            request_options=request_options,
-        )
-        return _response.data
-
-    async def create_async(
-        self,
-        agent_id: str,
-        *,
-        messages: typing.Sequence[LettaAsyncRequestMessagesItem],
-        max_steps: typing.Optional[int] = OMIT,
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
-        include_return_message_types: typing.Optional[typing.Sequence[MessageType]] = OMIT,
-        enable_thinking: typing.Optional[str] = OMIT,
-        callback_url: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> Run:
-        """
-        Asynchronously process a user message and return a run object.
-        The actual processing happens in the background, and the status can be checked using the run ID.
-
-        This is "asynchronous" in the sense that it's a background run and explicitly must be fetched by the run ID.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        messages : typing.Sequence[LettaAsyncRequestMessagesItem]
-            The messages to be sent to the agent.
-
-        max_steps : typing.Optional[int]
-            Maximum number of steps the agent should take to process the request.
-
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
-
-        include_return_message_types : typing.Optional[typing.Sequence[MessageType]]
-            Only return specified message types in the response. If `None` (default) returns all messages.
-
-        enable_thinking : typing.Optional[str]
-            If set to True, enables reasoning before responses or tool calls from the agent.
-
-        callback_url : typing.Optional[str]
-            Optional callback URL to POST to when the job completes
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        Run
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta, MessageCreate, TextContent
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.messages.create_async(
-                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-                messages=[
-                    MessageCreate(
-                        role="user",
-                        content=[
-                            TextContent(
-                                text="text",
-                            )
-                        ],
-                    )
-                ],
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.create_async(
-            agent_id,
-            messages=messages,
-            max_steps=max_steps,
-            use_assistant_message=use_assistant_message,
-            assistant_message_tool_name=assistant_message_tool_name,
-            assistant_message_tool_kwarg=assistant_message_tool_kwarg,
-            include_return_message_types=include_return_message_types,
-            enable_thinking=enable_thinking,
-            callback_url=callback_url,
-            request_options=request_options,
-        )
-        return _response.data
-
-    async def reset(
-        self,
-        agent_id: str,
-        *,
-        add_default_initial_messages: typing.Optional[bool] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> AgentState:
-        """
-        Resets the messages for an agent
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        add_default_initial_messages : typing.Optional[bool]
-            If true, adds the default initial messages after resetting.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        AgentState
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.messages.reset(
-                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-                add_default_initial_messages=True,
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.reset(
-            agent_id, add_default_initial_messages=add_default_initial_messages, request_options=request_options
-        )
-        return _response.data
-
-    async def preview(
-        self, agent_id: str, *, request: MessagesPreviewRequest, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Dict[str, typing.Optional[typing.Any]]:
-        """
-        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.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        request : MessagesPreviewRequest
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.Dict[str, typing.Optional[typing.Any]]
-            Successful Response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta, LettaRequest, MessageCreate, TextContent
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.messages.preview(
-                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-                request=LettaRequest(
-                    messages=[
-                        MessageCreate(
-                            role="user",
-                            content=[
-                                TextContent(
-                                    text="text",
-                                )
-                            ],
-                        )
-                    ],
-                ),
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.preview(agent_id, request=request, request_options=request_options)
-        return _response.data
-
-    async def summarize(
-        self, agent_id: str, *, max_message_length: int, request_options: typing.Optional[RequestOptions] = None
-    ) -> None:
-        """
-        Summarize an agent's conversation history to a target message length.
-
-        This endpoint summarizes the current message history for a given agent,
-        truncating and compressing it down to the specified `max_message_length`.
-
-        Parameters
-        ----------
-        agent_id : str
-            The ID of the agent in the format 'agent-<uuid4>'
-
-        max_message_length : int
-            Maximum number of messages to retain after summarization.
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.agents.messages.summarize(
-                agent_id="agent-123e4567-e89b-42d3-8456-426614174000",
-                max_message_length=1,
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._raw_client.summarize(
-            agent_id, max_message_length=max_message_length, request_options=request_options
-        )
-        return _response.data