letta-client 0.1.232__py3-none-any.whl → 0.1.234__py3-none-any.whl

letta_client/agents/templates/raw_client.py

@@ -0,0 +1,505 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ...core.api_error import ApiError
+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.http_response import AsyncHttpResponse, HttpResponse
+from ...core.jsonable_encoder import jsonable_encoder
+from ...core.request_options import RequestOptions
+from ...core.unchecked_base_model import construct_type
+from ...errors.conflict_error import ConflictError
+from ...errors.internal_server_error import InternalServerError
+from ...errors.not_found_error import NotFoundError
+from ...types.conflict_error_body import ConflictErrorBody
+from .types.templates_create_response import TemplatesCreateResponse
+from .types.templates_create_version_request_return_agent_state import TemplatesCreateVersionRequestReturnAgentState
+from .types.templates_migrate_response import TemplatesMigrateResponse
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawTemplatesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def create_version(
+        self,
+        agent_id: str,
+        *,
+        return_agent_state: typing.Optional[TemplatesCreateVersionRequestReturnAgentState] = None,
+        migrate_deployed_agents: typing.Optional[bool] = OMIT,
+        message: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[None]:
+        """
+        <Note>This endpoint is only available on Letta Cloud.</Note>
+
+        Creates a new version of the template version of the 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_state : typing.Optional[TemplatesCreateVersionRequestReturnAgentState]
+
+        migrate_deployed_agents : typing.Optional[bool]
+
+        message : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[None]
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/version-template",
+            method="POST",
+            params={
+                "returnAgentState": return_agent_state,
+            },
+            json={
+                "migrate_deployed_agents": migrate_deployed_agents,
+                "message": message,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return HttpResponse(response=_response, data=None)
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), 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,
+    ) -> HttpResponse[TemplatesMigrateResponse]:
+        """
+        <Note>This endpoint is only available on Letta Cloud.</Note>
+
+        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
+        -------
+        HttpResponse[TemplatesMigrateResponse]
+            200
+        """
+        _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:
+                _data = typing.cast(
+                    TemplatesMigrateResponse,
+                    construct_type(
+                        type_=TemplatesMigrateResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ConflictErrorBody,
+                        construct_type(
+                            type_=ConflictErrorBody,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def create(
+        self,
+        agent_id: str,
+        *,
+        project: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[TemplatesCreateResponse]:
+        """
+        <Note>This endpoint is only available on Letta Cloud.</Note>
+
+        Creates a template from an agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        project : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[TemplatesCreateResponse]
+            201
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/template",
+            method="POST",
+            json={
+                "project": project,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TemplatesCreateResponse,
+                    construct_type(
+                        type_=TemplatesCreateResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawTemplatesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def create_version(
+        self,
+        agent_id: str,
+        *,
+        return_agent_state: typing.Optional[TemplatesCreateVersionRequestReturnAgentState] = None,
+        migrate_deployed_agents: typing.Optional[bool] = OMIT,
+        message: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[None]:
+        """
+        <Note>This endpoint is only available on Letta Cloud.</Note>
+
+        Creates a new version of the template version of the 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_state : typing.Optional[TemplatesCreateVersionRequestReturnAgentState]
+
+        migrate_deployed_agents : typing.Optional[bool]
+
+        message : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[None]
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/version-template",
+            method="POST",
+            params={
+                "returnAgentState": return_agent_state,
+            },
+            json={
+                "migrate_deployed_agents": migrate_deployed_agents,
+                "message": message,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return AsyncHttpResponse(response=_response, data=None)
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), 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,
+    ) -> AsyncHttpResponse[TemplatesMigrateResponse]:
+        """
+        <Note>This endpoint is only available on Letta Cloud.</Note>
+
+        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
+        -------
+        AsyncHttpResponse[TemplatesMigrateResponse]
+            200
+        """
+        _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:
+                _data = typing.cast(
+                    TemplatesMigrateResponse,
+                    construct_type(
+                        type_=TemplatesMigrateResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 404:
+                raise NotFoundError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 409:
+                raise ConflictError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        ConflictErrorBody,
+                        construct_type(
+                            type_=ConflictErrorBody,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def create(
+        self,
+        agent_id: str,
+        *,
+        project: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[TemplatesCreateResponse]:
+        """
+        <Note>This endpoint is only available on Letta Cloud.</Note>
+
+        Creates a template from an agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        project : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[TemplatesCreateResponse]
+            201
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/template",
+            method="POST",
+            json={
+                "project": project,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    TemplatesCreateResponse,
+                    construct_type(
+                        type_=TemplatesCreateResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 500:
+                raise InternalServerError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

letta_client/agents/templates/types/__init__.py

@@ -1,5 +1,7 @@
 # This file was auto-generated by Fern from our API Definition.
 
+# isort: skip_file
+
 from .templates_create_response import TemplatesCreateResponse
 from .templates_create_version_request_return_agent_state import TemplatesCreateVersionRequestReturnAgentState
 from .templates_migrate_response import TemplatesMigrateResponse

letta_client/agents/templates/types/templates_create_response.py

@@ -1,11 +1,12 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ....core.unchecked_base_model import UncheckedBaseModel
-import typing_extensions
-from ....core.serialization import FieldMetadata
-from ....core.pydantic_utilities import IS_PYDANTIC_V2
 import typing
+
 import pydantic
+import typing_extensions
+from ....core.pydantic_utilities import IS_PYDANTIC_V2
+from ....core.serialization import FieldMetadata
+from ....core.unchecked_base_model import UncheckedBaseModel
 
 
 class TemplatesCreateResponse(UncheckedBaseModel):

letta_client/agents/templates/types/templates_migrate_response.py

@@ -1,9 +1,10 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ....core.unchecked_base_model import UncheckedBaseModel
-from ....core.pydantic_utilities import IS_PYDANTIC_V2
 import typing
+
 import pydantic
+from ....core.pydantic_utilities import IS_PYDANTIC_V2
+from ....core.unchecked_base_model import UncheckedBaseModel
 
 
 class TemplatesMigrateResponse(UncheckedBaseModel):

letta_client/agents/tools/__init__.py

@@ -1,2 +1,4 @@
 # This file was auto-generated by Fern from our API Definition.
 
+# isort: skip_file
+