letta-client 0.1.226__py3-none-any.whl → 1.7.2__py3-none-any.whl

letta_client/groups/messages/client.py

@@ -1,1015 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-from ...core.client_wrapper import SyncClientWrapper
-from ...core.request_options import RequestOptions
-from ...types.letta_message_union import LettaMessageUnion
-from ...core.jsonable_encoder import jsonable_encoder
-from ...core.unchecked_base_model import construct_type
-from ...errors.unprocessable_entity_error import UnprocessableEntityError
-from ...types.http_validation_error import HttpValidationError
-from json.decoder import JSONDecodeError
-from ...core.api_error import ApiError
-from ...types.message_create import MessageCreate
-from ...types.message_type import MessageType
-from ...types.letta_response import LettaResponse
-from ...core.serialization import convert_and_respect_annotation_metadata
-from .types.letta_streaming_response import LettaStreamingResponse
-import httpx_sse
-import json
-from .types.messages_modify_request import MessagesModifyRequest
-from .types.messages_modify_response import MessagesModifyResponse
-from ...core.client_wrapper import AsyncClientWrapper
-
-# this is used as the default value for optional parameters
-OMIT = typing.cast(typing.Any, ...)
-
-
-class MessagesClient:
-    def __init__(self, *, client_wrapper: SyncClientWrapper):
-        self._client_wrapper = client_wrapper
-
-    def list(
-        self,
-        group_id: str,
-        *,
-        after: typing.Optional[str] = None,
-        before: typing.Optional[str] = None,
-        limit: typing.Optional[int] = None,
-        use_assistant_message: typing.Optional[bool] = None,
-        assistant_message_tool_name: typing.Optional[str] = None,
-        assistant_message_tool_kwarg: typing.Optional[str] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.List[LettaMessageUnion]:
-        """
-        Retrieve message history for an agent.
-
-        Parameters
-        ----------
-        group_id : str
-
-        after : typing.Optional[str]
-            Message after which to retrieve the returned messages.
-
-        before : typing.Optional[str]
-            Message before which to retrieve the returned messages.
-
-        limit : typing.Optional[int]
-            Maximum number of messages to retrieve.
-
-        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.
-
-        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.groups.messages.list(
-            group_id="group_id",
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/groups/{jsonable_encoder(group_id)}/messages",
-            method="GET",
-            params={
-                "after": after,
-                "before": before,
-                "limit": limit,
-                "use_assistant_message": use_assistant_message,
-                "assistant_message_tool_name": assistant_message_tool_name,
-                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
-            },
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    typing.List[LettaMessageUnion],
-                    construct_type(
-                        type_=typing.List[LettaMessageUnion],  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    def create(
-        self,
-        group_id: str,
-        *,
-        messages: typing.Sequence[MessageCreate],
-        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 group's response.
-        This endpoint accepts a message from a user and processes it through through agents in the group based on the specified pattern
-
-        Parameters
-        ----------
-        group_id : str
-
-        messages : typing.Sequence[MessageCreate]
-            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.groups.messages.create(
-            group_id="group_id",
-            messages=[
-                MessageCreate(
-                    role="user",
-                    content=[
-                        TextContent(
-                            text="text",
-                        )
-                    ],
-                )
-            ],
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/groups/{jsonable_encoder(group_id)}/messages",
-            method="POST",
-            json={
-                "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
-                ),
-                "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,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    LettaResponse,
-                    construct_type(
-                        type_=LettaResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    def create_stream(
-        self,
-        group_id: str,
-        *,
-        messages: typing.Sequence[MessageCreate],
-        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,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.Iterator[LettaStreamingResponse]:
-        """
-        Process a user message and return the group's responses.
-        This endpoint accepts a message from a user and processes it through agents in the group based on the specified pattern.
-        It will stream the steps of the response always, and stream the tokens if 'stream_tokens' is set to True.
-
-        Parameters
-        ----------
-        group_id : str
-
-        messages : typing.Sequence[MessageCreate]
-            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. Set to True for token streaming (requires stream_steps = True).
-
-        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.groups.messages.create_stream(
-            group_id="group_id",
-            messages=[
-                MessageCreate(
-                    role="user",
-                    content=[
-                        TextContent(
-                            text="text",
-                        )
-                    ],
-                )
-            ],
-        )
-        for chunk in response:
-            yield chunk
-        """
-        with self._client_wrapper.httpx_client.stream(
-            f"v1/groups/{jsonable_encoder(group_id)}/messages/stream",
-            method="POST",
-            json={
-                "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
-                ),
-                "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,
-            },
-            request_options=request_options,
-            omit=OMIT,
-        ) as _response:
-            try:
-                if 200 <= _response.status_code < 300:
-                    _event_source = httpx_sse.EventSource(_response)
-                    for _sse in _event_source.iter_sse():
-                        try:
-                            yield typing.cast(
-                                LettaStreamingResponse,
-                                construct_type(
-                                    type_=LettaStreamingResponse,  # type: ignore
-                                    object_=json.loads(_sse.data),
-                                ),
-                            )
-                        except:
-                            pass
-                    return
-                _response.read()
-                if _response.status_code == 422:
-                    raise UnprocessableEntityError(
-                        typing.cast(
-                            HttpValidationError,
-                            construct_type(
-                                type_=HttpValidationError,  # type: ignore
-                                object_=_response.json(),
-                            ),
-                        )
-                    )
-                _response_json = _response.json()
-            except JSONDecodeError:
-                raise ApiError(status_code=_response.status_code, body=_response.text)
-            raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    def modify(
-        self,
-        group_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
-        ----------
-        group_id : str
-
-        message_id : str
-
-        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.groups.messages.modify(
-            group_id="group_id",
-            message_id="message_id",
-            request=UpdateSystemMessage(
-                content="content",
-            ),
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/groups/{jsonable_encoder(group_id)}/messages/{jsonable_encoder(message_id)}",
-            method="PATCH",
-            json=convert_and_respect_annotation_metadata(
-                object_=request, annotation=MessagesModifyRequest, direction="write"
-            ),
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    MessagesModifyResponse,
-                    construct_type(
-                        type_=MessagesModifyResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    def reset(
-        self, group_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Optional[typing.Any]:
-        """
-        Delete the group messages for all agents that are part of the multi-agent group.
-
-        Parameters
-        ----------
-        group_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        typing.Optional[typing.Any]
-            Successful Response
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.groups.messages.reset(
-            group_id="group_id",
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/groups/{jsonable_encoder(group_id)}/reset-messages",
-            method="PATCH",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    typing.Optional[typing.Any],
-                    construct_type(
-                        type_=typing.Optional[typing.Any],  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
-
-class AsyncMessagesClient:
-    def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
-
-    async def list(
-        self,
-        group_id: str,
-        *,
-        after: typing.Optional[str] = None,
-        before: typing.Optional[str] = None,
-        limit: typing.Optional[int] = None,
-        use_assistant_message: typing.Optional[bool] = None,
-        assistant_message_tool_name: typing.Optional[str] = None,
-        assistant_message_tool_kwarg: typing.Optional[str] = None,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.List[LettaMessageUnion]:
-        """
-        Retrieve message history for an agent.
-
-        Parameters
-        ----------
-        group_id : str
-
-        after : typing.Optional[str]
-            Message after which to retrieve the returned messages.
-
-        before : typing.Optional[str]
-            Message before which to retrieve the returned messages.
-
-        limit : typing.Optional[int]
-            Maximum number of messages to retrieve.
-
-        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.
-
-        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.groups.messages.list(
-                group_id="group_id",
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/groups/{jsonable_encoder(group_id)}/messages",
-            method="GET",
-            params={
-                "after": after,
-                "before": before,
-                "limit": limit,
-                "use_assistant_message": use_assistant_message,
-                "assistant_message_tool_name": assistant_message_tool_name,
-                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
-            },
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    typing.List[LettaMessageUnion],
-                    construct_type(
-                        type_=typing.List[LettaMessageUnion],  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    async def create(
-        self,
-        group_id: str,
-        *,
-        messages: typing.Sequence[MessageCreate],
-        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 group's response.
-        This endpoint accepts a message from a user and processes it through through agents in the group based on the specified pattern
-
-        Parameters
-        ----------
-        group_id : str
-
-        messages : typing.Sequence[MessageCreate]
-            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.groups.messages.create(
-                group_id="group_id",
-                messages=[
-                    MessageCreate(
-                        role="user",
-                        content=[
-                            TextContent(
-                                text="text",
-                            )
-                        ],
-                    )
-                ],
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/groups/{jsonable_encoder(group_id)}/messages",
-            method="POST",
-            json={
-                "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
-                ),
-                "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,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    LettaResponse,
-                    construct_type(
-                        type_=LettaResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    async def create_stream(
-        self,
-        group_id: str,
-        *,
-        messages: typing.Sequence[MessageCreate],
-        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,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> typing.AsyncIterator[LettaStreamingResponse]:
-        """
-        Process a user message and return the group's responses.
-        This endpoint accepts a message from a user and processes it through agents in the group based on the specified pattern.
-        It will stream the steps of the response always, and stream the tokens if 'stream_tokens' is set to True.
-
-        Parameters
-        ----------
-        group_id : str
-
-        messages : typing.Sequence[MessageCreate]
-            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. Set to True for token streaming (requires stream_steps = True).
-
-        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.groups.messages.create_stream(
-                group_id="group_id",
-                messages=[
-                    MessageCreate(
-                        role="user",
-                        content=[
-                            TextContent(
-                                text="text",
-                            )
-                        ],
-                    )
-                ],
-            )
-            async for chunk in response:
-                yield chunk
-
-
-        asyncio.run(main())
-        """
-        async with self._client_wrapper.httpx_client.stream(
-            f"v1/groups/{jsonable_encoder(group_id)}/messages/stream",
-            method="POST",
-            json={
-                "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
-                ),
-                "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,
-            },
-            request_options=request_options,
-            omit=OMIT,
-        ) as _response:
-            try:
-                if 200 <= _response.status_code < 300:
-                    _event_source = httpx_sse.EventSource(_response)
-                    async for _sse in _event_source.aiter_sse():
-                        try:
-                            yield typing.cast(
-                                LettaStreamingResponse,
-                                construct_type(
-                                    type_=LettaStreamingResponse,  # type: ignore
-                                    object_=json.loads(_sse.data),
-                                ),
-                            )
-                        except:
-                            pass
-                    return
-                await _response.aread()
-                if _response.status_code == 422:
-                    raise UnprocessableEntityError(
-                        typing.cast(
-                            HttpValidationError,
-                            construct_type(
-                                type_=HttpValidationError,  # type: ignore
-                                object_=_response.json(),
-                            ),
-                        )
-                    )
-                _response_json = _response.json()
-            except JSONDecodeError:
-                raise ApiError(status_code=_response.status_code, body=_response.text)
-            raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    async def modify(
-        self,
-        group_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
-        ----------
-        group_id : str
-
-        message_id : str
-
-        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.groups.messages.modify(
-                group_id="group_id",
-                message_id="message_id",
-                request=UpdateSystemMessage(
-                    content="content",
-                ),
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/groups/{jsonable_encoder(group_id)}/messages/{jsonable_encoder(message_id)}",
-            method="PATCH",
-            json=convert_and_respect_annotation_metadata(
-                object_=request, annotation=MessagesModifyRequest, direction="write"
-            ),
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    MessagesModifyResponse,
-                    construct_type(
-                        type_=MessagesModifyResponse,  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
-    async def reset(
-        self, group_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Optional[typing.Any]:
-        """
-        Delete the group messages for all agents that are part of the multi-agent group.
-
-        Parameters
-        ----------
-        group_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        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.groups.messages.reset(
-                group_id="group_id",
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/groups/{jsonable_encoder(group_id)}/reset-messages",
-            method="PATCH",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    typing.Optional[typing.Any],
-                    construct_type(
-                        type_=typing.Optional[typing.Any],  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
-            if _response.status_code == 422:
-                raise UnprocessableEntityError(
-                    typing.cast(
-                        HttpValidationError,
-                        construct_type(
-                            type_=HttpValidationError,  # type: ignore
-                            object_=_response.json(),
-                        ),
-                    )
-                )
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)