letta-client 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

letta/agents/client.py

@@ -0,0 +1,2166 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from ..core.client_wrapper import SyncClientWrapper
+from .context.client import ContextClient
+from .tools.client import ToolsClient
+from .sources.client import SourcesClient
+from .memory.client import MemoryClient
+from .memory_blocks.client import MemoryBlocksClient
+from .recall_memory.client import RecallMemoryClient
+from .archival_memory.client import ArchivalMemoryClient
+from .messages.client import MessagesClient
+from ..core.request_options import RequestOptions
+from ..types.agent_state import AgentState
+from ..core.pydantic_utilities import parse_obj_as
+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.create_block import CreateBlock
+from .types.create_agent_request_tool_rules_item import CreateAgentRequestToolRulesItem
+from ..types.agent_type import AgentType
+from ..types.llm_config import LlmConfig
+from ..types.embedding_config import EmbeddingConfig
+from ..types.message_create import MessageCreate
+from ..core.serialization import convert_and_respect_annotation_metadata
+from ..core.jsonable_encoder import jsonable_encoder
+from .types.update_agent_tool_rules_item import UpdateAgentToolRulesItem
+from ..types.block import Block
+from ..types.job import Job
+from .types.agents_create_version_response import AgentsCreateVersionResponse
+from ..errors.not_found_error import NotFoundError
+from ..errors.internal_server_error import InternalServerError
+from .types.agents_migrate_response import AgentsMigrateResponse
+from ..errors.conflict_error import ConflictError
+from ..types.conflict_error_body import ConflictErrorBody
+from ..core.client_wrapper import AsyncClientWrapper
+from .context.client import AsyncContextClient
+from .tools.client import AsyncToolsClient
+from .sources.client import AsyncSourcesClient
+from .memory.client import AsyncMemoryClient
+from .memory_blocks.client import AsyncMemoryBlocksClient
+from .recall_memory.client import AsyncRecallMemoryClient
+from .archival_memory.client import AsyncArchivalMemoryClient
+from .messages.client import AsyncMessagesClient
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class AgentsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+        self.context = ContextClient(client_wrapper=self._client_wrapper)
+        self.tools = ToolsClient(client_wrapper=self._client_wrapper)
+        self.sources = SourcesClient(client_wrapper=self._client_wrapper)
+        self.memory = MemoryClient(client_wrapper=self._client_wrapper)
+        self.memory_blocks = MemoryBlocksClient(client_wrapper=self._client_wrapper)
+        self.recall_memory = RecallMemoryClient(client_wrapper=self._client_wrapper)
+        self.archival_memory = ArchivalMemoryClient(client_wrapper=self._client_wrapper)
+        self.messages = MessagesClient(client_wrapper=self._client_wrapper)
+
+    def list(
+        self,
+        *,
+        name: typing.Optional[str] = None,
+        tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        match_all_tags: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[AgentState]:
+        """
+        List all agents associated with a given user.
+        This endpoint retrieves a list of all agents and their configurations associated with the specified user ID.
+
+        Parameters
+        ----------
+        name : typing.Optional[str]
+            Name of the agent
+
+        tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            List of tags to filter agents by
+
+        match_all_tags : typing.Optional[bool]
+            If True, only returns agents that match ALL given tags. Otherwise, return agents that have ANY of the passed in tags.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[AgentState]
+            Successful Response
+
+        Examples
+        --------
+        from letta import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.list()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/agents/",
+            method="GET",
+            params={
+                "name": name,
+                "tags": tags,
+                "match_all_tags": match_all_tags,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[AgentState],
+                    parse_obj_as(
+                        type_=typing.List[AgentState],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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,
+        *,
+        memory_blocks: typing.Sequence[CreateBlock],
+        name: typing.Optional[str] = OMIT,
+        tools: typing.Optional[typing.Sequence[str]] = OMIT,
+        tool_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        source_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        block_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        tool_rules: typing.Optional[typing.Sequence[CreateAgentRequestToolRulesItem]] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
+        system: typing.Optional[str] = OMIT,
+        agent_type: typing.Optional[AgentType] = OMIT,
+        llm_config: typing.Optional[LlmConfig] = OMIT,
+        embedding_config: typing.Optional[EmbeddingConfig] = OMIT,
+        initial_message_sequence: typing.Optional[typing.Sequence[MessageCreate]] = OMIT,
+        include_base_tools: typing.Optional[bool] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        llm: typing.Optional[str] = OMIT,
+        embedding: typing.Optional[str] = OMIT,
+        context_window_limit: typing.Optional[int] = OMIT,
+        embedding_chunk_size: typing.Optional[int] = OMIT,
+        user_id: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentState:
+        """
+        Create a new agent with the specified configuration.
+
+        Parameters
+        ----------
+        memory_blocks : typing.Sequence[CreateBlock]
+            The blocks to create in the agent's in-context memory.
+
+        name : typing.Optional[str]
+            The name of the agent.
+
+        tools : typing.Optional[typing.Sequence[str]]
+            The tools used by the agent.
+
+        tool_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the tools used by the agent.
+
+        source_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the sources used by the agent.
+
+        block_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the blocks used by the agent.
+
+        tool_rules : typing.Optional[typing.Sequence[CreateAgentRequestToolRulesItem]]
+            The tool rules governing the agent.
+
+        tags : typing.Optional[typing.Sequence[str]]
+            The tags associated with the agent.
+
+        system : typing.Optional[str]
+            The system prompt used by the agent.
+
+        agent_type : typing.Optional[AgentType]
+            The type of agent.
+
+        llm_config : typing.Optional[LlmConfig]
+            The LLM configuration used by the agent.
+
+        embedding_config : typing.Optional[EmbeddingConfig]
+            The embedding configuration used by the agent.
+
+        initial_message_sequence : typing.Optional[typing.Sequence[MessageCreate]]
+            The initial set of messages to put in the agent's in-context memory.
+
+        include_base_tools : typing.Optional[bool]
+            The LLM configuration used by the agent.
+
+        description : typing.Optional[str]
+            The description of the agent.
+
+        metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            The metadata of the agent.
+
+        llm : typing.Optional[str]
+            The LLM configuration handle used by the agent, specified in the format provider/model-name, as an alternative to specifying llm_config.
+
+        embedding : typing.Optional[str]
+            The embedding configuration handle used by the agent, specified in the format provider/model-name.
+
+        context_window_limit : typing.Optional[int]
+            The context window limit used by the agent.
+
+        embedding_chunk_size : typing.Optional[int]
+            The embedding chunk size used by the agent.
+
+        user_id : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        from letta import CreateBlock, Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.create(
+            memory_blocks=[
+                CreateBlock(
+                    value="value",
+                    label="label",
+                )
+            ],
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/agents/",
+            method="POST",
+            json={
+                "name": name,
+                "memory_blocks": convert_and_respect_annotation_metadata(
+                    object_=memory_blocks, annotation=typing.Sequence[CreateBlock], direction="write"
+                ),
+                "tools": tools,
+                "tool_ids": tool_ids,
+                "source_ids": source_ids,
+                "block_ids": block_ids,
+                "tool_rules": convert_and_respect_annotation_metadata(
+                    object_=tool_rules, annotation=typing.Sequence[CreateAgentRequestToolRulesItem], direction="write"
+                ),
+                "tags": tags,
+                "system": system,
+                "agent_type": agent_type,
+                "llm_config": convert_and_respect_annotation_metadata(
+                    object_=llm_config, annotation=LlmConfig, direction="write"
+                ),
+                "embedding_config": convert_and_respect_annotation_metadata(
+                    object_=embedding_config, annotation=EmbeddingConfig, direction="write"
+                ),
+                "initial_message_sequence": convert_and_respect_annotation_metadata(
+                    object_=initial_message_sequence, annotation=typing.Sequence[MessageCreate], direction="write"
+                ),
+                "include_base_tools": include_base_tools,
+                "description": description,
+                "metadata_": metadata,
+                "llm": llm,
+                "embedding": embedding,
+                "context_window_limit": context_window_limit,
+                "embedding_chunk_size": embedding_chunk_size,
+                "user_id": user_id,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentState,
+                    parse_obj_as(
+                        type_=AgentState,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 get(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> AgentState:
+        """
+        Get the state of the agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        from letta import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.get(
+            agent_id="agent_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentState,
+                    parse_obj_as(
+                        type_=AgentState,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 delete(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> AgentState:
+        """
+        Delete an agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        from letta import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.delete(
+            agent_id="agent_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentState,
+                    parse_obj_as(
+                        type_=AgentState,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 update(
+        self,
+        agent_id: str,
+        *,
+        name: typing.Optional[str] = OMIT,
+        tool_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        source_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        block_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
+        system: typing.Optional[str] = OMIT,
+        tool_rules: typing.Optional[typing.Sequence[UpdateAgentToolRulesItem]] = OMIT,
+        llm_config: typing.Optional[LlmConfig] = OMIT,
+        embedding_config: typing.Optional[EmbeddingConfig] = OMIT,
+        message_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentState:
+        """
+        Update an exsiting agent
+
+        Parameters
+        ----------
+        agent_id : str
+
+        name : typing.Optional[str]
+            The name of the agent.
+
+        tool_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the tools used by the agent.
+
+        source_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the sources used by the agent.
+
+        block_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the blocks used by the agent.
+
+        tags : typing.Optional[typing.Sequence[str]]
+            The tags associated with the agent.
+
+        system : typing.Optional[str]
+            The system prompt used by the agent.
+
+        tool_rules : typing.Optional[typing.Sequence[UpdateAgentToolRulesItem]]
+            The tool rules governing the agent.
+
+        llm_config : typing.Optional[LlmConfig]
+            The LLM configuration used by the agent.
+
+        embedding_config : typing.Optional[EmbeddingConfig]
+            The embedding configuration used by the agent.
+
+        message_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the messages in the agent's in-context memory.
+
+        description : typing.Optional[str]
+            The description of the agent.
+
+        metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            The metadata of the agent.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        from letta import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.update(
+            agent_id="agent_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}",
+            method="PATCH",
+            json={
+                "name": name,
+                "tool_ids": tool_ids,
+                "source_ids": source_ids,
+                "block_ids": block_ids,
+                "tags": tags,
+                "system": system,
+                "tool_rules": convert_and_respect_annotation_metadata(
+                    object_=tool_rules, annotation=typing.Sequence[UpdateAgentToolRulesItem], direction="write"
+                ),
+                "llm_config": convert_and_respect_annotation_metadata(
+                    object_=llm_config, annotation=LlmConfig, direction="write"
+                ),
+                "embedding_config": convert_and_respect_annotation_metadata(
+                    object_=embedding_config, annotation=EmbeddingConfig, direction="write"
+                ),
+                "message_ids": message_ids,
+                "description": description,
+                "metadata_": metadata,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentState,
+                    parse_obj_as(
+                        type_=AgentState,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 get_agent_memory_block(
+        self, agent_id: str, block_label: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> Block:
+        """
+        Retrieve a memory block from an agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        block_label : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Block
+            Successful Response
+
+        Examples
+        --------
+        from letta import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.get_agent_memory_block(
+            agent_id="agent_id",
+            block_label="block_label",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/memory/block/{jsonable_encoder(block_label)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    Block,
+                    parse_obj_as(
+                        type_=Block,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 update_agent_memory_block_by_label(
+        self,
+        agent_id: str,
+        block_label: str,
+        *,
+        value: typing.Optional[str] = OMIT,
+        limit: typing.Optional[int] = OMIT,
+        name: typing.Optional[str] = OMIT,
+        is_template: typing.Optional[bool] = OMIT,
+        label: typing.Optional[str] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Block:
+        """
+        Removes a memory block from an agent by unlnking it. If the block is not linked to any other agent, it is deleted.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        block_label : str
+
+        value : typing.Optional[str]
+            Value of the block.
+
+        limit : typing.Optional[int]
+            Character limit of the block.
+
+        name : typing.Optional[str]
+            Name of the block if it is a template.
+
+        is_template : typing.Optional[bool]
+            Whether the block is a template (e.g. saved human/persona options).
+
+        label : typing.Optional[str]
+            Label of the block (e.g. 'human', 'persona') in the context window.
+
+        description : typing.Optional[str]
+            Description of the block.
+
+        metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Metadata of the block.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Block
+            Successful Response
+
+        Examples
+        --------
+        from letta import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.update_agent_memory_block_by_label(
+            agent_id="agent_id",
+            block_label="block_label",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/memory/block/{jsonable_encoder(block_label)}",
+            method="PATCH",
+            json={
+                "value": value,
+                "limit": limit,
+                "name": name,
+                "is_template": is_template,
+                "label": label,
+                "description": description,
+                "metadata_": metadata,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    Block,
+                    parse_obj_as(
+                        type_=Block,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 get_agent_memory_blocks(
+        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[Block]:
+        """
+        Retrieve the memory blocks of a specific agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[Block]
+            Successful Response
+
+        Examples
+        --------
+        from letta import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.get_agent_memory_blocks(
+            agent_id="agent_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/memory/block",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[Block],
+                    parse_obj_as(
+                        type_=typing.List[Block],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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_agent_message_async(
+        self,
+        agent_id: str,
+        *,
+        messages: typing.Sequence[MessageCreate],
+        assistant_message_tool_name: typing.Optional[str] = OMIT,
+        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Job:
+        """
+        Asynchronously process a user message and return a job ID.
+        The actual processing happens in the background, and the status can be checked using the job ID.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        messages : typing.Sequence[MessageCreate]
+            The messages to be sent to the agent.
+
+        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.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Job
+            Successful Response
+
+        Examples
+        --------
+        from letta import Letta, MessageCreate
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.create_agent_message_async(
+            agent_id="agent_id",
+            messages=[
+                MessageCreate(
+                    role="user",
+                    text="text",
+                )
+            ],
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/messages/async",
+            method="POST",
+            json={
+                "messages": convert_and_respect_annotation_metadata(
+                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
+                ),
+                "assistant_message_tool_name": assistant_message_tool_name,
+                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    Job,
+                    parse_obj_as(
+                        type_=Job,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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_version(
+        self,
+        agent_id: str,
+        *,
+        return_agent_id: typing.Optional[bool] = None,
+        migrate_deployed_agents: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentsCreateVersionResponse:
+        """
+        Creates a versioned version of an agent
+
+        Parameters
+        ----------
+        agent_id : str
+            The agent ID of the agent to migrate, if this agent is not a template, it will create a agent template from the agent provided as well
+
+        return_agent_id : typing.Optional[bool]
+
+        migrate_deployed_agents : typing.Optional[bool]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentsCreateVersionResponse
+            201
+
+        Examples
+        --------
+        from letta import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.create_version(
+            agent_id="agent_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/version-template",
+            method="POST",
+            params={
+                "returnAgentId": return_agent_id,
+            },
+            json={
+                "migrate_deployed_agents": migrate_deployed_agents,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentsCreateVersionResponse,
+                    parse_obj_as(
+                        type_=AgentsCreateVersionResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # 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 migrate(
+        self,
+        agent_id: str,
+        *,
+        to_template: str,
+        preserve_core_memories: bool,
+        variables: typing.Optional[typing.Dict[str, str]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentsMigrateResponse:
+        """
+        Migrate an agent to a new versioned agent template
+
+        Parameters
+        ----------
+        agent_id : str
+
+        to_template : str
+
+        preserve_core_memories : bool
+
+        variables : typing.Optional[typing.Dict[str, str]]
+            If you chose to not preserve core memories, you should provide the new variables for the core memories
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentsMigrateResponse
+            200
+
+        Examples
+        --------
+        from letta import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.migrate(
+            agent_id="agent_id",
+            to_template="to_template",
+            preserve_core_memories=True,
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/migrate",
+            method="POST",
+            json={
+                "to_template": to_template,
+                "variables": variables,
+                "preserve_core_memories": preserve_core_memories,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentsMigrateResponse,
+                    parse_obj_as(
+                        type_=AgentsMigrateResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    typing.cast(
+                        ConflictErrorBody,
+                        parse_obj_as(
+                            type_=ConflictErrorBody,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # 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 AsyncAgentsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+        self.context = AsyncContextClient(client_wrapper=self._client_wrapper)
+        self.tools = AsyncToolsClient(client_wrapper=self._client_wrapper)
+        self.sources = AsyncSourcesClient(client_wrapper=self._client_wrapper)
+        self.memory = AsyncMemoryClient(client_wrapper=self._client_wrapper)
+        self.memory_blocks = AsyncMemoryBlocksClient(client_wrapper=self._client_wrapper)
+        self.recall_memory = AsyncRecallMemoryClient(client_wrapper=self._client_wrapper)
+        self.archival_memory = AsyncArchivalMemoryClient(client_wrapper=self._client_wrapper)
+        self.messages = AsyncMessagesClient(client_wrapper=self._client_wrapper)
+
+    async def list(
+        self,
+        *,
+        name: typing.Optional[str] = None,
+        tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        match_all_tags: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[AgentState]:
+        """
+        List all agents associated with a given user.
+        This endpoint retrieves a list of all agents and their configurations associated with the specified user ID.
+
+        Parameters
+        ----------
+        name : typing.Optional[str]
+            Name of the agent
+
+        tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            List of tags to filter agents by
+
+        match_all_tags : typing.Optional[bool]
+            If True, only returns agents that match ALL given tags. Otherwise, return agents that have ANY of the passed in tags.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[AgentState]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.list()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/agents/",
+            method="GET",
+            params={
+                "name": name,
+                "tags": tags,
+                "match_all_tags": match_all_tags,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[AgentState],
+                    parse_obj_as(
+                        type_=typing.List[AgentState],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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,
+        *,
+        memory_blocks: typing.Sequence[CreateBlock],
+        name: typing.Optional[str] = OMIT,
+        tools: typing.Optional[typing.Sequence[str]] = OMIT,
+        tool_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        source_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        block_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        tool_rules: typing.Optional[typing.Sequence[CreateAgentRequestToolRulesItem]] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
+        system: typing.Optional[str] = OMIT,
+        agent_type: typing.Optional[AgentType] = OMIT,
+        llm_config: typing.Optional[LlmConfig] = OMIT,
+        embedding_config: typing.Optional[EmbeddingConfig] = OMIT,
+        initial_message_sequence: typing.Optional[typing.Sequence[MessageCreate]] = OMIT,
+        include_base_tools: typing.Optional[bool] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        llm: typing.Optional[str] = OMIT,
+        embedding: typing.Optional[str] = OMIT,
+        context_window_limit: typing.Optional[int] = OMIT,
+        embedding_chunk_size: typing.Optional[int] = OMIT,
+        user_id: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentState:
+        """
+        Create a new agent with the specified configuration.
+
+        Parameters
+        ----------
+        memory_blocks : typing.Sequence[CreateBlock]
+            The blocks to create in the agent's in-context memory.
+
+        name : typing.Optional[str]
+            The name of the agent.
+
+        tools : typing.Optional[typing.Sequence[str]]
+            The tools used by the agent.
+
+        tool_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the tools used by the agent.
+
+        source_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the sources used by the agent.
+
+        block_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the blocks used by the agent.
+
+        tool_rules : typing.Optional[typing.Sequence[CreateAgentRequestToolRulesItem]]
+            The tool rules governing the agent.
+
+        tags : typing.Optional[typing.Sequence[str]]
+            The tags associated with the agent.
+
+        system : typing.Optional[str]
+            The system prompt used by the agent.
+
+        agent_type : typing.Optional[AgentType]
+            The type of agent.
+
+        llm_config : typing.Optional[LlmConfig]
+            The LLM configuration used by the agent.
+
+        embedding_config : typing.Optional[EmbeddingConfig]
+            The embedding configuration used by the agent.
+
+        initial_message_sequence : typing.Optional[typing.Sequence[MessageCreate]]
+            The initial set of messages to put in the agent's in-context memory.
+
+        include_base_tools : typing.Optional[bool]
+            The LLM configuration used by the agent.
+
+        description : typing.Optional[str]
+            The description of the agent.
+
+        metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            The metadata of the agent.
+
+        llm : typing.Optional[str]
+            The LLM configuration handle used by the agent, specified in the format provider/model-name, as an alternative to specifying llm_config.
+
+        embedding : typing.Optional[str]
+            The embedding configuration handle used by the agent, specified in the format provider/model-name.
+
+        context_window_limit : typing.Optional[int]
+            The context window limit used by the agent.
+
+        embedding_chunk_size : typing.Optional[int]
+            The embedding chunk size used by the agent.
+
+        user_id : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta, CreateBlock
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.create(
+                memory_blocks=[
+                    CreateBlock(
+                        value="value",
+                        label="label",
+                    )
+                ],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/agents/",
+            method="POST",
+            json={
+                "name": name,
+                "memory_blocks": convert_and_respect_annotation_metadata(
+                    object_=memory_blocks, annotation=typing.Sequence[CreateBlock], direction="write"
+                ),
+                "tools": tools,
+                "tool_ids": tool_ids,
+                "source_ids": source_ids,
+                "block_ids": block_ids,
+                "tool_rules": convert_and_respect_annotation_metadata(
+                    object_=tool_rules, annotation=typing.Sequence[CreateAgentRequestToolRulesItem], direction="write"
+                ),
+                "tags": tags,
+                "system": system,
+                "agent_type": agent_type,
+                "llm_config": convert_and_respect_annotation_metadata(
+                    object_=llm_config, annotation=LlmConfig, direction="write"
+                ),
+                "embedding_config": convert_and_respect_annotation_metadata(
+                    object_=embedding_config, annotation=EmbeddingConfig, direction="write"
+                ),
+                "initial_message_sequence": convert_and_respect_annotation_metadata(
+                    object_=initial_message_sequence, annotation=typing.Sequence[MessageCreate], direction="write"
+                ),
+                "include_base_tools": include_base_tools,
+                "description": description,
+                "metadata_": metadata,
+                "llm": llm,
+                "embedding": embedding,
+                "context_window_limit": context_window_limit,
+                "embedding_chunk_size": embedding_chunk_size,
+                "user_id": user_id,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentState,
+                    parse_obj_as(
+                        type_=AgentState,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 get(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> AgentState:
+        """
+        Get the state of the agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.get(
+                agent_id="agent_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentState,
+                    parse_obj_as(
+                        type_=AgentState,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 delete(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> AgentState:
+        """
+        Delete an agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.delete(
+                agent_id="agent_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentState,
+                    parse_obj_as(
+                        type_=AgentState,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 update(
+        self,
+        agent_id: str,
+        *,
+        name: typing.Optional[str] = OMIT,
+        tool_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        source_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        block_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
+        system: typing.Optional[str] = OMIT,
+        tool_rules: typing.Optional[typing.Sequence[UpdateAgentToolRulesItem]] = OMIT,
+        llm_config: typing.Optional[LlmConfig] = OMIT,
+        embedding_config: typing.Optional[EmbeddingConfig] = OMIT,
+        message_ids: typing.Optional[typing.Sequence[str]] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentState:
+        """
+        Update an exsiting agent
+
+        Parameters
+        ----------
+        agent_id : str
+
+        name : typing.Optional[str]
+            The name of the agent.
+
+        tool_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the tools used by the agent.
+
+        source_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the sources used by the agent.
+
+        block_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the blocks used by the agent.
+
+        tags : typing.Optional[typing.Sequence[str]]
+            The tags associated with the agent.
+
+        system : typing.Optional[str]
+            The system prompt used by the agent.
+
+        tool_rules : typing.Optional[typing.Sequence[UpdateAgentToolRulesItem]]
+            The tool rules governing the agent.
+
+        llm_config : typing.Optional[LlmConfig]
+            The LLM configuration used by the agent.
+
+        embedding_config : typing.Optional[EmbeddingConfig]
+            The embedding configuration used by the agent.
+
+        message_ids : typing.Optional[typing.Sequence[str]]
+            The ids of the messages in the agent's in-context memory.
+
+        description : typing.Optional[str]
+            The description of the agent.
+
+        metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            The metadata of the agent.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.update(
+                agent_id="agent_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}",
+            method="PATCH",
+            json={
+                "name": name,
+                "tool_ids": tool_ids,
+                "source_ids": source_ids,
+                "block_ids": block_ids,
+                "tags": tags,
+                "system": system,
+                "tool_rules": convert_and_respect_annotation_metadata(
+                    object_=tool_rules, annotation=typing.Sequence[UpdateAgentToolRulesItem], direction="write"
+                ),
+                "llm_config": convert_and_respect_annotation_metadata(
+                    object_=llm_config, annotation=LlmConfig, direction="write"
+                ),
+                "embedding_config": convert_and_respect_annotation_metadata(
+                    object_=embedding_config, annotation=EmbeddingConfig, direction="write"
+                ),
+                "message_ids": message_ids,
+                "description": description,
+                "metadata_": metadata,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentState,
+                    parse_obj_as(
+                        type_=AgentState,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 get_agent_memory_block(
+        self, agent_id: str, block_label: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> Block:
+        """
+        Retrieve a memory block from an agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        block_label : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Block
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.get_agent_memory_block(
+                agent_id="agent_id",
+                block_label="block_label",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/memory/block/{jsonable_encoder(block_label)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    Block,
+                    parse_obj_as(
+                        type_=Block,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 update_agent_memory_block_by_label(
+        self,
+        agent_id: str,
+        block_label: str,
+        *,
+        value: typing.Optional[str] = OMIT,
+        limit: typing.Optional[int] = OMIT,
+        name: typing.Optional[str] = OMIT,
+        is_template: typing.Optional[bool] = OMIT,
+        label: typing.Optional[str] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Block:
+        """
+        Removes a memory block from an agent by unlnking it. If the block is not linked to any other agent, it is deleted.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        block_label : str
+
+        value : typing.Optional[str]
+            Value of the block.
+
+        limit : typing.Optional[int]
+            Character limit of the block.
+
+        name : typing.Optional[str]
+            Name of the block if it is a template.
+
+        is_template : typing.Optional[bool]
+            Whether the block is a template (e.g. saved human/persona options).
+
+        label : typing.Optional[str]
+            Label of the block (e.g. 'human', 'persona') in the context window.
+
+        description : typing.Optional[str]
+            Description of the block.
+
+        metadata : typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]]
+            Metadata of the block.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Block
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.update_agent_memory_block_by_label(
+                agent_id="agent_id",
+                block_label="block_label",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/memory/block/{jsonable_encoder(block_label)}",
+            method="PATCH",
+            json={
+                "value": value,
+                "limit": limit,
+                "name": name,
+                "is_template": is_template,
+                "label": label,
+                "description": description,
+                "metadata_": metadata,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    Block,
+                    parse_obj_as(
+                        type_=Block,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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 get_agent_memory_blocks(
+        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[Block]:
+        """
+        Retrieve the memory blocks of a specific agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[Block]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.get_agent_memory_blocks(
+                agent_id="agent_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/memory/block",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[Block],
+                    parse_obj_as(
+                        type_=typing.List[Block],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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_agent_message_async(
+        self,
+        agent_id: str,
+        *,
+        messages: typing.Sequence[MessageCreate],
+        assistant_message_tool_name: typing.Optional[str] = OMIT,
+        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Job:
+        """
+        Asynchronously process a user message and return a job ID.
+        The actual processing happens in the background, and the status can be checked using the job ID.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        messages : typing.Sequence[MessageCreate]
+            The messages to be sent to the agent.
+
+        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.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Job
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta, MessageCreate
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.create_agent_message_async(
+                agent_id="agent_id",
+                messages=[
+                    MessageCreate(
+                        role="user",
+                        text="text",
+                    )
+                ],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/messages/async",
+            method="POST",
+            json={
+                "messages": convert_and_respect_annotation_metadata(
+                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
+                ),
+                "assistant_message_tool_name": assistant_message_tool_name,
+                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    Job,
+                    parse_obj_as(
+                        type_=Job,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        parse_obj_as(
+                            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_version(
+        self,
+        agent_id: str,
+        *,
+        return_agent_id: typing.Optional[bool] = None,
+        migrate_deployed_agents: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentsCreateVersionResponse:
+        """
+        Creates a versioned version of an agent
+
+        Parameters
+        ----------
+        agent_id : str
+            The agent ID of the agent to migrate, if this agent is not a template, it will create a agent template from the agent provided as well
+
+        return_agent_id : typing.Optional[bool]
+
+        migrate_deployed_agents : typing.Optional[bool]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentsCreateVersionResponse
+            201
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.create_version(
+                agent_id="agent_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/version-template",
+            method="POST",
+            params={
+                "returnAgentId": return_agent_id,
+            },
+            json={
+                "migrate_deployed_agents": migrate_deployed_agents,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentsCreateVersionResponse,
+                    parse_obj_as(
+                        type_=AgentsCreateVersionResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # 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 migrate(
+        self,
+        agent_id: str,
+        *,
+        to_template: str,
+        preserve_core_memories: bool,
+        variables: typing.Optional[typing.Dict[str, str]] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentsMigrateResponse:
+        """
+        Migrate an agent to a new versioned agent template
+
+        Parameters
+        ----------
+        agent_id : str
+
+        to_template : str
+
+        preserve_core_memories : bool
+
+        variables : typing.Optional[typing.Dict[str, str]]
+            If you chose to not preserve core memories, you should provide the new variables for the core memories
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentsMigrateResponse
+            200
+
+        Examples
+        --------
+        import asyncio
+
+        from letta import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.migrate(
+                agent_id="agent_id",
+                to_template="to_template",
+                preserve_core_memories=True,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/migrate",
+            method="POST",
+            json={
+                "to_template": to_template,
+                "variables": variables,
+                "preserve_core_memories": preserve_core_memories,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    AgentsMigrateResponse,
+                    parse_obj_as(
+                        type_=AgentsMigrateResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    typing.cast(
+                        ConflictErrorBody,
+                        parse_obj_as(
+                            type_=ConflictErrorBody,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # 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)