letta-client 0.1.267__py3-none-any.whl → 0.1.268__py3-none-any.whl

letta_client/__init__.py

@@ -146,7 +146,6 @@ from .types import (
     InitToolRule,
     InputAudio,
     InputAudioFormat,
-    InternalServerErrorBody,
     Job,
     JobStatus,
     JobType,
@@ -201,7 +200,6 @@ from .types import (
     ModalSandboxConfig,
     ModalSandboxConfigLanguage,
     NotFoundErrorBody,
-    NotFoundErrorBodyMessage,
     NpmRequirement,
     OmittedReasoningContent,
     OpenaiTypesChatChatCompletionCustomToolParamCustom,
@@ -310,14 +308,7 @@ from .types import (
     WebSearchOptionsUserLocation,
     WebSearchOptionsUserLocationApproximate,
 )
-from .errors import (
-    BadRequestError,
-    ConflictError,
-    InternalServerError,
-    NotFoundError,
-    PaymentRequiredError,
-    UnprocessableEntityError,
-)
+from .errors import BadRequestError, ConflictError, NotFoundError, PaymentRequiredError, UnprocessableEntityError
 from . import (
     agents,
     batches,
@@ -376,7 +367,36 @@ from .environment import LettaEnvironment
 from .groups import GroupCreateManagerConfig, GroupUpdateManagerConfig
 from .projects import ProjectsListResponse, ProjectsListResponseProjectsItem
 from .steps import StepsListRequestFeedback
-from .templates import TemplatesListResponse, TemplatesListResponseTemplatesItem
+from .templates import (
+    TemplatesCreateTemplateResponse,
+    TemplatesDeleteTemplateResponse,
+    TemplatesForkTemplateResponse,
+    TemplatesGetTemplateSnapshotResponse,
+    TemplatesGetTemplateSnapshotResponseAgentsItem,
+    TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariables,
+    TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariablesDataItem,
+    TemplatesGetTemplateSnapshotResponseAgentsItemProperties,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItem,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemChildOutputMapping,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemFive,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemFour,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemMaxCountLimit,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemOne,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemSeven,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemTwo,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemZero,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolVariables,
+    TemplatesGetTemplateSnapshotResponseAgentsItemToolVariablesDataItem,
+    TemplatesGetTemplateSnapshotResponseBlocksItem,
+    TemplatesGetTemplateSnapshotResponseConfiguration,
+    TemplatesGetTemplateSnapshotResponseType,
+    TemplatesListResponse,
+    TemplatesListResponseTemplatesItem,
+    TemplatesListTemplateVersionsResponse,
+    TemplatesListTemplateVersionsResponseVersionsItem,
+    TemplatesRenameTemplateResponse,
+    TemplatesSaveTemplateVersionResponse,
+)
 from .tools import (
     AddMcpServerRequest,
     AddMcpServerResponseItem,
@@ -568,8 +588,6 @@ __all__ = [
     "InitToolRule",
     "InputAudio",
     "InputAudioFormat",
-    "InternalServerError",
-    "InternalServerErrorBody",
     "Job",
     "JobStatus",
     "JobType",
@@ -628,7 +646,6 @@ __all__ = [
     "ModalSandboxConfigLanguage",
     "NotFoundError",
     "NotFoundErrorBody",
-    "NotFoundErrorBodyMessage",
     "NpmRequirement",
     "OmittedReasoningContent",
     "OpenaiTypesChatChatCompletionCustomToolParamCustom",
@@ -696,8 +713,34 @@ __all__ = [
     "SupervisorManagerUpdate",
     "SystemMessage",
     "TagSchema",
+    "TemplatesCreateTemplateResponse",
+    "TemplatesDeleteTemplateResponse",
+    "TemplatesForkTemplateResponse",
+    "TemplatesGetTemplateSnapshotResponse",
+    "TemplatesGetTemplateSnapshotResponseAgentsItem",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariables",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariablesDataItem",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemProperties",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItem",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemChildOutputMapping",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemFive",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemFour",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemMaxCountLimit",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemOne",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemSeven",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemTwo",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItemZero",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolVariables",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemToolVariablesDataItem",
+    "TemplatesGetTemplateSnapshotResponseBlocksItem",
+    "TemplatesGetTemplateSnapshotResponseConfiguration",
+    "TemplatesGetTemplateSnapshotResponseType",
     "TemplatesListResponse",
     "TemplatesListResponseTemplatesItem",
+    "TemplatesListTemplateVersionsResponse",
+    "TemplatesListTemplateVersionsResponseVersionsItem",
+    "TemplatesRenameTemplateResponse",
+    "TemplatesSaveTemplateVersionResponse",
     "TerminalToolRule",
     "TestMcpServerRequest",
     "TextContent",

letta_client/agents/__init__.py

@@ -39,7 +39,7 @@ from .messages import (
     MessagesModifyResponse,
     MessagesPreviewRawPayloadRequest,
 )
-from .templates import TemplatesCreateResponse, TemplatesCreateVersionRequestReturnAgentState, TemplatesMigrateResponse
+from .templates import TemplatesMigrateResponse
 
 __all__ = [
     "AgentsSearchRequestSearchItem",
@@ -59,8 +59,6 @@ __all__ = [
     "MessagesModifyRequest",
     "MessagesModifyResponse",
     "MessagesPreviewRawPayloadRequest",
-    "TemplatesCreateResponse",
-    "TemplatesCreateVersionRequestReturnAgentState",
     "TemplatesMigrateResponse",
     "UpdateAgentResponseFormat",
     "UpdateAgentToolRulesItem",

letta_client/agents/templates/__init__.py

@@ -2,6 +2,6 @@
 
 # isort: skip_file
 
-from .types import TemplatesCreateResponse, TemplatesCreateVersionRequestReturnAgentState, TemplatesMigrateResponse
+from .types import TemplatesMigrateResponse
 
-__all__ = ["TemplatesCreateResponse", "TemplatesCreateVersionRequestReturnAgentState", "TemplatesMigrateResponse"]
+__all__ = ["TemplatesMigrateResponse"]

letta_client/agents/templates/client.py

@@ -5,8 +5,6 @@ import typing
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
 from .raw_client import AsyncRawTemplatesClient, RawTemplatesClient
-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
@@ -28,41 +26,38 @@ class TemplatesClient:
         """
         return self._raw_client
 
-    def create_version(
+    def migrate(
         self,
         agent_id: str,
         *,
-        return_agent_state: typing.Optional[TemplatesCreateVersionRequestReturnAgentState] = None,
-        migrate_deployed_agents: typing.Optional[bool] = OMIT,
-        message: typing.Optional[str] = OMIT,
+        to_template: str,
+        preserve_core_memories: bool,
         preserve_tool_variables: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> None:
+    ) -> TemplatesMigrateResponse:
         """
         <Note>This endpoint is only available on Letta Cloud.</Note>
 
-        Creates a new version of the template version of the agent.
+        Migrate an agent to a new versioned agent template.
 
         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]
+        to_template : str
 
-        message : typing.Optional[str]
+        preserve_core_memories : bool
 
         preserve_tool_variables : typing.Optional[bool]
-            If true, preserves the existing agent's tool environment variables when migrating deployed agents
+            If true, preserves the existing agent's tool environment variables instead of using the template's variables
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        None
+        TemplatesMigrateResponse
+            200
 
         Examples
         --------
@@ -72,56 +67,37 @@ class TemplatesClient:
             project="YOUR_PROJECT",
             token="YOUR_TOKEN",
         )
-        client.agents.templates.create_version(
+        client.agents.templates.migrate(
             agent_id="agent_id",
+            to_template="to_template",
+            preserve_core_memories=True,
         )
         """
-        _response = self._raw_client.create_version(
+        _response = self._raw_client.migrate(
             agent_id,
-            return_agent_state=return_agent_state,
-            migrate_deployed_agents=migrate_deployed_agents,
-            message=message,
+            to_template=to_template,
+            preserve_core_memories=preserve_core_memories,
             preserve_tool_variables=preserve_tool_variables,
             request_options=request_options,
         )
         return _response.data
 
-    def migrate(
-        self,
-        agent_id: str,
-        *,
-        to_template: str,
-        preserve_core_memories: bool,
-        variables: typing.Optional[typing.Dict[str, str]] = OMIT,
-        preserve_tool_variables: typing.Optional[bool] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> TemplatesMigrateResponse:
+    def create(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
         <Note>This endpoint is only available on Letta Cloud.</Note>
 
-        Migrate an agent to a new versioned agent template.
+        Creates a template from an agent.
 
         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
-
-        preserve_tool_variables : typing.Optional[bool]
-            If true, preserves the existing agent's tool environment variables instead of using the template's variables
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        TemplatesMigrateResponse
-            200
+        None
 
         Examples
         --------
@@ -131,47 +107,29 @@ class TemplatesClient:
             project="YOUR_PROJECT",
             token="YOUR_TOKEN",
         )
-        client.agents.templates.migrate(
+        client.agents.templates.create(
             agent_id="agent_id",
-            to_template="to_template",
-            preserve_core_memories=True,
         )
         """
-        _response = self._raw_client.migrate(
-            agent_id,
-            to_template=to_template,
-            preserve_core_memories=preserve_core_memories,
-            variables=variables,
-            preserve_tool_variables=preserve_tool_variables,
-            request_options=request_options,
-        )
+        _response = self._raw_client.create(agent_id, request_options=request_options)
         return _response.data
 
-    def create(
-        self,
-        agent_id: str,
-        *,
-        project: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> TemplatesCreateResponse:
+    def create_version(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
         <Note>This endpoint is only available on Letta Cloud.</Note>
 
-        Creates a template from an agent.
+        Creates a new version of the template version of the agent.
 
         Parameters
         ----------
         agent_id : str
 
-        project : typing.Optional[str]
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        TemplatesCreateResponse
-            201
+        None
 
         Examples
         --------
@@ -181,11 +139,11 @@ class TemplatesClient:
             project="YOUR_PROJECT",
             token="YOUR_TOKEN",
         )
-        client.agents.templates.create(
+        client.agents.templates.create_version(
             agent_id="agent_id",
         )
         """
-        _response = self._raw_client.create(agent_id, project=project, request_options=request_options)
+        _response = self._raw_client.create_version(agent_id, request_options=request_options)
         return _response.data
 
 
@@ -204,41 +162,38 @@ class AsyncTemplatesClient:
         """
         return self._raw_client
 
-    async def create_version(
+    async def migrate(
         self,
         agent_id: str,
         *,
-        return_agent_state: typing.Optional[TemplatesCreateVersionRequestReturnAgentState] = None,
-        migrate_deployed_agents: typing.Optional[bool] = OMIT,
-        message: typing.Optional[str] = OMIT,
+        to_template: str,
+        preserve_core_memories: bool,
         preserve_tool_variables: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> None:
+    ) -> TemplatesMigrateResponse:
         """
         <Note>This endpoint is only available on Letta Cloud.</Note>
 
-        Creates a new version of the template version of the agent.
+        Migrate an agent to a new versioned agent template.
 
         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]
+        to_template : str
 
-        message : typing.Optional[str]
+        preserve_core_memories : bool
 
         preserve_tool_variables : typing.Optional[bool]
-            If true, preserves the existing agent's tool environment variables when migrating deployed agents
+            If true, preserves the existing agent's tool environment variables instead of using the template's variables
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        None
+        TemplatesMigrateResponse
+            200
 
         Examples
         --------
@@ -253,59 +208,40 @@ class AsyncTemplatesClient:
 
 
         async def main() -> None:
-            await client.agents.templates.create_version(
+            await client.agents.templates.migrate(
                 agent_id="agent_id",
+                to_template="to_template",
+                preserve_core_memories=True,
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.create_version(
+        _response = await self._raw_client.migrate(
             agent_id,
-            return_agent_state=return_agent_state,
-            migrate_deployed_agents=migrate_deployed_agents,
-            message=message,
+            to_template=to_template,
+            preserve_core_memories=preserve_core_memories,
             preserve_tool_variables=preserve_tool_variables,
             request_options=request_options,
         )
         return _response.data
 
-    async def migrate(
-        self,
-        agent_id: str,
-        *,
-        to_template: str,
-        preserve_core_memories: bool,
-        variables: typing.Optional[typing.Dict[str, str]] = OMIT,
-        preserve_tool_variables: typing.Optional[bool] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> TemplatesMigrateResponse:
+    async def create(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
         <Note>This endpoint is only available on Letta Cloud.</Note>
 
-        Migrate an agent to a new versioned agent template.
+        Creates a template from an agent.
 
         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
-
-        preserve_tool_variables : typing.Optional[bool]
-            If true, preserves the existing agent's tool environment variables instead of using the template's variables
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        TemplatesMigrateResponse
-            200
+        None
 
         Examples
         --------
@@ -320,50 +256,32 @@ class AsyncTemplatesClient:
 
 
         async def main() -> None:
-            await client.agents.templates.migrate(
+            await client.agents.templates.create(
                 agent_id="agent_id",
-                to_template="to_template",
-                preserve_core_memories=True,
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.migrate(
-            agent_id,
-            to_template=to_template,
-            preserve_core_memories=preserve_core_memories,
-            variables=variables,
-            preserve_tool_variables=preserve_tool_variables,
-            request_options=request_options,
-        )
+        _response = await self._raw_client.create(agent_id, request_options=request_options)
         return _response.data
 
-    async def create(
-        self,
-        agent_id: str,
-        *,
-        project: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> TemplatesCreateResponse:
+    async def create_version(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
         <Note>This endpoint is only available on Letta Cloud.</Note>
 
-        Creates a template from an agent.
+        Creates a new version of the template version of the agent.
 
         Parameters
         ----------
         agent_id : str
 
-        project : typing.Optional[str]
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        TemplatesCreateResponse
-            201
+        None
 
         Examples
         --------
@@ -378,12 +296,12 @@ class AsyncTemplatesClient:
 
 
         async def main() -> None:
-            await client.agents.templates.create(
+            await client.agents.templates.create_version(
                 agent_id="agent_id",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.create(agent_id, project=project, request_options=request_options)
+        _response = await self._raw_client.create_version(agent_id, request_options=request_options)
         return _response.data