letta-client 0.1.251__py3-none-any.whl → 0.1.253__py3-none-any.whl

letta_client/__init__.py

@@ -7,8 +7,7 @@ from .types import (
     ActionParametersModel,
     ActionResponseModel,
     AgentEnvironmentVariable,
-    AgentSchema,
-    AgentSchemaToolRulesItem,
+    AgentFileSchema,
     AgentState,
     AgentStateResponseFormat,
     AgentStateToolRulesItem,
@@ -27,7 +26,9 @@ from .types import (
     BaseToolRuleSchema,
     BatchJob,
     Block,
+    BlockSchema,
     BlockUpdate,
+    BodyExportAgentSerialized,
     ChatCompletionAssistantMessageParam,
     ChatCompletionAssistantMessageParamContent,
     ChatCompletionAssistantMessageParamContentItem,
@@ -95,10 +96,12 @@ from .types import (
     EmbeddingConfigEmbeddingEndpointType,
     FeedbackType,
     File,
+    FileAgentSchema,
     FileBlock,
     FileFile,
     FileMetadata,
     FileProcessingStatus,
+    FileSchema,
     FileStats,
     Folder,
     FunctionCall,
@@ -109,6 +112,8 @@ from .types import (
     GenerateToolInput,
     GenerateToolOutput,
     Group,
+    GroupSchema,
+    GroupSchemaManagerConfig,
     Health,
     HiddenReasoningMessage,
     HiddenReasoningMessageState,
@@ -122,6 +127,7 @@ from .types import (
     ImageContentSource,
     ImageUrl,
     ImageUrlDetail,
+    ImportedAgentsResponse,
     InitToolRule,
     InputAudio,
     InputAudioFormat,
@@ -141,6 +147,16 @@ from .types import (
     LettaRequest,
     LettaRequestConfig,
     LettaResponse,
+    LettaSchemasAgentFileAgentSchema,
+    LettaSchemasAgentFileAgentSchemaResponseFormat,
+    LettaSchemasAgentFileAgentSchemaToolRulesItem,
+    LettaSchemasAgentFileMessageSchema,
+    LettaSchemasAgentFileMessageSchemaContent,
+    LettaSchemasAgentFileToolSchema,
+    LettaSerializeSchemasPydanticAgentSchemaAgentSchema,
+    LettaSerializeSchemasPydanticAgentSchemaAgentSchemaToolRulesItem,
+    LettaSerializeSchemasPydanticAgentSchemaMessageSchema,
+    LettaSerializeSchemasPydanticAgentSchemaToolSchema,
     LettaStopReason,
     LettaStreamingRequest,
     LettaUsageStatistics,
@@ -153,6 +169,7 @@ from .types import (
     ManagerType,
     MaxCountPerStepToolRule,
     MaxCountPerStepToolRuleSchema,
+    McpServerSchema,
     McpServerType,
     McpTool,
     Memory,
@@ -162,7 +179,6 @@ from .types import (
     MessageCreateContent,
     MessageCreateRole,
     MessageRole,
-    MessageSchema,
     MessageType,
     ModalSandboxConfig,
     ModalSandboxConfigLanguage,
@@ -212,6 +228,7 @@ from .types import (
     SleeptimeManagerUpdate,
     Source,
     SourceCreate,
+    SourceSchema,
     SourceStats,
     SourceUpdate,
     SseServerConfig,
@@ -243,7 +260,6 @@ from .types import (
     ToolReturnMessage,
     ToolReturnMessageStatus,
     ToolReturnStatus,
-    ToolSchema,
     ToolType,
     UpdateAssistantMessage,
     UpdateAssistantMessageContent,
@@ -360,8 +376,7 @@ __all__ = [
     "AddMcpServerRequest",
     "AddMcpServerResponseItem",
     "AgentEnvironmentVariable",
-    "AgentSchema",
-    "AgentSchemaToolRulesItem",
+    "AgentFileSchema",
     "AgentState",
     "AgentStateResponseFormat",
     "AgentStateToolRulesItem",
@@ -392,7 +407,9 @@ __all__ = [
     "BaseToolRuleSchema",
     "BatchJob",
     "Block",
+    "BlockSchema",
     "BlockUpdate",
+    "BodyExportAgentSerialized",
     "ChatCompletionAssistantMessageParam",
     "ChatCompletionAssistantMessageParamContent",
     "ChatCompletionAssistantMessageParamContentItem",
@@ -477,10 +494,12 @@ __all__ = [
     "EmbeddingConfigEmbeddingEndpointType",
     "FeedbackType",
     "File",
+    "FileAgentSchema",
     "FileBlock",
     "FileFile",
     "FileMetadata",
     "FileProcessingStatus",
+    "FileSchema",
     "FileStats",
     "Folder",
     "FunctionCall",
@@ -492,6 +511,8 @@ __all__ = [
     "GenerateToolOutput",
     "Group",
     "GroupCreateManagerConfig",
+    "GroupSchema",
+    "GroupSchemaManagerConfig",
     "GroupUpdateManagerConfig",
     "Health",
     "HiddenReasoningMessage",
@@ -506,6 +527,7 @@ __all__ = [
     "ImageContentSource",
     "ImageUrl",
     "ImageUrlDetail",
+    "ImportedAgentsResponse",
     "InitToolRule",
     "InputAudio",
     "InputAudioFormat",
@@ -528,6 +550,16 @@ __all__ = [
     "LettaRequest",
     "LettaRequestConfig",
     "LettaResponse",
+    "LettaSchemasAgentFileAgentSchema",
+    "LettaSchemasAgentFileAgentSchemaResponseFormat",
+    "LettaSchemasAgentFileAgentSchemaToolRulesItem",
+    "LettaSchemasAgentFileMessageSchema",
+    "LettaSchemasAgentFileMessageSchemaContent",
+    "LettaSchemasAgentFileToolSchema",
+    "LettaSerializeSchemasPydanticAgentSchemaAgentSchema",
+    "LettaSerializeSchemasPydanticAgentSchemaAgentSchemaToolRulesItem",
+    "LettaSerializeSchemasPydanticAgentSchemaMessageSchema",
+    "LettaSerializeSchemasPydanticAgentSchemaToolSchema",
     "LettaStopReason",
     "LettaStreamingRequest",
     "LettaUsageStatistics",
@@ -541,6 +573,7 @@ __all__ = [
     "ManagerType",
     "MaxCountPerStepToolRule",
     "MaxCountPerStepToolRuleSchema",
+    "McpServerSchema",
     "McpServerType",
     "McpTool",
     "Memory",
@@ -550,7 +583,6 @@ __all__ = [
     "MessageCreateContent",
     "MessageCreateRole",
     "MessageRole",
-    "MessageSchema",
     "MessageType",
     "ModalSandboxConfig",
     "ModalSandboxConfigLanguage",
@@ -604,6 +636,7 @@ __all__ = [
     "SleeptimeManagerUpdate",
     "Source",
     "SourceCreate",
+    "SourceSchema",
     "SourceStats",
     "SourceUpdate",
     "SseServerConfig",
@@ -640,7 +673,6 @@ __all__ = [
     "ToolReturnMessage",
     "ToolReturnMessageStatus",
     "ToolReturnStatus",
-    "ToolSchema",
     "ToolType",
     "UnprocessableEntityError",
     "UpdateAgentResponseFormat",

letta_client/agents/client.py

@@ -10,6 +10,7 @@ from ..types.agent_state import AgentState
 from ..types.agent_type import AgentType
 from ..types.create_block import CreateBlock
 from ..types.embedding_config import EmbeddingConfig
+from ..types.imported_agents_response import ImportedAgentsResponse
 from ..types.llm_config import LlmConfig
 from ..types.message_create import MessageCreate
 from .blocks.client import AsyncBlocksClient, BlocksClient
@@ -466,17 +467,25 @@ class AgentsClient:
         agent_id: str,
         *,
         max_steps: typing.Optional[int] = None,
+        use_legacy_format: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> str:
         """
         Export the serialized JSON representation of an agent, formatted with indentation.
 
+        Supports two export formats:
+        - Legacy format (use_legacy_format=true): Single agent with inline tools/blocks
+        - New format (default): Multi-entity format with separate agents, tools, blocks, files, etc.
+
         Parameters
         ----------
         agent_id : str
 
         max_steps : typing.Optional[int]
 
+        use_legacy_format : typing.Optional[bool]
+            If true, exports using the legacy single-agent format. If false, exports using the new multi-entity format.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -497,7 +506,9 @@ class AgentsClient:
             agent_id="agent_id",
         )
         """
-        _response = self._raw_client.export_file(agent_id, max_steps=max_steps, request_options=request_options)
+        _response = self._raw_client.export_file(
+            agent_id, max_steps=max_steps, use_legacy_format=use_legacy_format, request_options=request_options
+        )
         return _response.data
 
     def import_file(
@@ -510,9 +521,10 @@ class AgentsClient:
         strip_messages: typing.Optional[bool] = OMIT,
         env_vars: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AgentState:
+    ) -> ImportedAgentsResponse:
         """
-        Import a serialized agent file and recreate the agent in the system.
+        Import a serialized agent file and recreate the agent(s) in the system.
+        Returns the IDs of all imported agents.
 
         Parameters
         ----------
@@ -539,7 +551,7 @@ class AgentsClient:
 
         Returns
         -------
-        AgentState
+        ImportedAgentsResponse
             Successful Response
 
         Examples
@@ -1380,17 +1392,25 @@ class AsyncAgentsClient:
         agent_id: str,
         *,
         max_steps: typing.Optional[int] = None,
+        use_legacy_format: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> str:
         """
         Export the serialized JSON representation of an agent, formatted with indentation.
 
+        Supports two export formats:
+        - Legacy format (use_legacy_format=true): Single agent with inline tools/blocks
+        - New format (default): Multi-entity format with separate agents, tools, blocks, files, etc.
+
         Parameters
         ----------
         agent_id : str
 
         max_steps : typing.Optional[int]
 
+        use_legacy_format : typing.Optional[bool]
+            If true, exports using the legacy single-agent format. If false, exports using the new multi-entity format.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1419,7 +1439,9 @@ class AsyncAgentsClient:
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.export_file(agent_id, max_steps=max_steps, request_options=request_options)
+        _response = await self._raw_client.export_file(
+            agent_id, max_steps=max_steps, use_legacy_format=use_legacy_format, request_options=request_options
+        )
         return _response.data
 
     async def import_file(
@@ -1432,9 +1454,10 @@ class AsyncAgentsClient:
         strip_messages: typing.Optional[bool] = OMIT,
         env_vars: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AgentState:
+    ) -> ImportedAgentsResponse:
         """
-        Import a serialized agent file and recreate the agent in the system.
+        Import a serialized agent file and recreate the agent(s) in the system.
+        Returns the IDs of all imported agents.
 
         Parameters
         ----------
@@ -1461,7 +1484,7 @@ class AsyncAgentsClient:
 
         Returns
         -------
-        AgentState
+        ImportedAgentsResponse
             Successful Response
 
         Examples

letta_client/agents/raw_client.py

@@ -18,6 +18,7 @@ from ..types.agent_type import AgentType
 from ..types.create_block import CreateBlock
 from ..types.embedding_config import EmbeddingConfig
 from ..types.http_validation_error import HttpValidationError
+from ..types.imported_agents_response import ImportedAgentsResponse
 from ..types.llm_config import LlmConfig
 from ..types.message_create import MessageCreate
 from .types.agents_search_request_search_item import AgentsSearchRequestSearchItem
@@ -497,17 +498,25 @@ class RawAgentsClient:
         agent_id: str,
         *,
         max_steps: typing.Optional[int] = None,
+        use_legacy_format: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[str]:
         """
         Export the serialized JSON representation of an agent, formatted with indentation.
 
+        Supports two export formats:
+        - Legacy format (use_legacy_format=true): Single agent with inline tools/blocks
+        - New format (default): Multi-entity format with separate agents, tools, blocks, files, etc.
+
         Parameters
         ----------
         agent_id : str
 
         max_steps : typing.Optional[int]
 
+        use_legacy_format : typing.Optional[bool]
+            If true, exports using the legacy single-agent format. If false, exports using the new multi-entity format.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -521,6 +530,7 @@ class RawAgentsClient:
             method="GET",
             params={
                 "max_steps": max_steps,
+                "use_legacy_format": use_legacy_format,
             },
             request_options=request_options,
         )
@@ -560,9 +570,10 @@ class RawAgentsClient:
         strip_messages: typing.Optional[bool] = OMIT,
         env_vars: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> HttpResponse[AgentState]:
+    ) -> HttpResponse[ImportedAgentsResponse]:
         """
-        Import a serialized agent file and recreate the agent in the system.
+        Import a serialized agent file and recreate the agent(s) in the system.
+        Returns the IDs of all imported agents.
 
         Parameters
         ----------
@@ -589,7 +600,7 @@ class RawAgentsClient:
 
         Returns
         -------
-        HttpResponse[AgentState]
+        HttpResponse[ImportedAgentsResponse]
             Successful Response
         """
         _response = self._client_wrapper.httpx_client.request(
@@ -612,9 +623,9 @@ class RawAgentsClient:
         try:
             if 200 <= _response.status_code < 300:
                 _data = typing.cast(
-                    AgentState,
+                    ImportedAgentsResponse,
                     construct_type(
-                        type_=AgentState,  # type: ignore
+                        type_=ImportedAgentsResponse,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -1548,17 +1559,25 @@ class AsyncRawAgentsClient:
         agent_id: str,
         *,
         max_steps: typing.Optional[int] = None,
+        use_legacy_format: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[str]:
         """
         Export the serialized JSON representation of an agent, formatted with indentation.
 
+        Supports two export formats:
+        - Legacy format (use_legacy_format=true): Single agent with inline tools/blocks
+        - New format (default): Multi-entity format with separate agents, tools, blocks, files, etc.
+
         Parameters
         ----------
         agent_id : str
 
         max_steps : typing.Optional[int]
 
+        use_legacy_format : typing.Optional[bool]
+            If true, exports using the legacy single-agent format. If false, exports using the new multi-entity format.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1572,6 +1591,7 @@ class AsyncRawAgentsClient:
             method="GET",
             params={
                 "max_steps": max_steps,
+                "use_legacy_format": use_legacy_format,
             },
             request_options=request_options,
         )
@@ -1611,9 +1631,10 @@ class AsyncRawAgentsClient:
         strip_messages: typing.Optional[bool] = OMIT,
         env_vars: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> AsyncHttpResponse[AgentState]:
+    ) -> AsyncHttpResponse[ImportedAgentsResponse]:
         """
-        Import a serialized agent file and recreate the agent in the system.
+        Import a serialized agent file and recreate the agent(s) in the system.
+        Returns the IDs of all imported agents.
 
         Parameters
         ----------
@@ -1640,7 +1661,7 @@ class AsyncRawAgentsClient:
 
         Returns
         -------
-        AsyncHttpResponse[AgentState]
+        AsyncHttpResponse[ImportedAgentsResponse]
             Successful Response
         """
         _response = await self._client_wrapper.httpx_client.request(
@@ -1663,9 +1684,9 @@ class AsyncRawAgentsClient:
         try:
             if 200 <= _response.status_code < 300:
                 _data = typing.cast(
-                    AgentState,
+                    ImportedAgentsResponse,
                     construct_type(
-                        type_=AgentState,  # type: ignore
+                        type_=ImportedAgentsResponse,  # type: ignore
                         object_=_response.json(),
                     ),
                 )

letta_client/core/client_wrapper.py

@@ -24,10 +24,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "letta-client/0.1.251",
+            "User-Agent": "letta-client/0.1.253",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.251",
+            "X-Fern-SDK-Version": "0.1.253",
             **(self.get_custom_headers() or {}),
         }
         if self._project is not None:

letta_client/tools/client.py

@@ -770,7 +770,7 @@ class ToolsClient:
         self, mcp_server_name: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.List[DeleteMcpServerResponseItem]:
         """
-        Add a new MCP server to the Letta MCP server config
+        Delete a MCP server configuration
 
         Parameters
         ----------
@@ -1794,7 +1794,7 @@ class AsyncToolsClient:
         self, mcp_server_name: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.List[DeleteMcpServerResponseItem]:
         """
-        Add a new MCP server to the Letta MCP server config
+        Delete a MCP server configuration
 
         Parameters
         ----------

letta_client/tools/raw_client.py

@@ -1085,7 +1085,7 @@ class RawToolsClient:
         self, mcp_server_name: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[typing.List[DeleteMcpServerResponseItem]]:
         """
-        Add a new MCP server to the Letta MCP server config
+        Delete a MCP server configuration
 
         Parameters
         ----------
@@ -2379,7 +2379,7 @@ class AsyncRawToolsClient:
         self, mcp_server_name: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[typing.List[DeleteMcpServerResponseItem]]:
         """
-        Add a new MCP server to the Letta MCP server config
+        Delete a MCP server configuration
 
         Parameters
         ----------