letta-client 0.1.68__tar.gz → 0.1.70__tar.gz

{letta_client-0.1.68 → letta_client-0.1.70}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: letta-client
-Version: 0.1.68
+Version: 0.1.70
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers

{letta_client-0.1.68 → letta_client-0.1.70}/pyproject.toml

@@ -3,7 +3,7 @@ name = "letta-client"
 
 [tool.poetry]
 name = "letta-client"
-version = "0.1.68"
+version = "0.1.70"
 description = ""
 readme = "README.md"
 authors = []

{letta_client-0.1.68 → letta_client-0.1.70}/src/letta_client/__init__.py

@@ -5,6 +5,7 @@ from .types import (
     ActionParametersModel,
     ActionResponseModel,
     AgentEnvironmentVariable,
+    AgentSchema,
     AgentState,
     AgentStateToolRulesItem,
     AgentType,
@@ -73,6 +74,7 @@ from .types import (
     ConflictErrorBody,
     ContextWindowOverview,
     ContinueToolRule,
+    CoreMemoryBlockSchema,
     CreateBlock,
     DynamicManager,
     E2BSandboxConfig,
@@ -116,7 +118,6 @@ from .types import (
     LlmConfig,
     LlmConfigModelEndpointType,
     LocalSandboxConfig,
-    LocalServerConfig,
     ManagerType,
     McpServerType,
     McpTool,
@@ -126,6 +127,7 @@ from .types import (
     MessageCreateContent,
     MessageCreateRole,
     MessageRole,
+    MessageSchema,
     NotFoundErrorBody,
     NotFoundErrorBodyMessage,
     OpenaiTypesChatChatCompletionMessageToolCallParamFunction,
@@ -133,6 +135,8 @@ from .types import (
     OpenaiTypesChatCompletionCreateParamsFunction,
     Organization,
     OrganizationCreate,
+    ParameterProperties,
+    ParametersSchema,
     Passage,
     PipRequirement,
     Provider,
@@ -153,10 +157,12 @@ from .types import (
     SandboxType,
     Source,
     SseServerConfig,
+    StdioServerConfig,
     Step,
     SupervisorManager,
     SystemMessage,
     SystemMessageContent,
+    TagSchema,
     TerminalToolRule,
     TextContent,
     Tool,
@@ -165,10 +171,14 @@ from .types import (
     ToolCallMessage,
     ToolCallMessageToolCall,
     ToolCreate,
+    ToolEnvVarSchema,
+    ToolJsonSchema,
     ToolReturn,
     ToolReturnMessage,
     ToolReturnMessageStatus,
     ToolReturnStatus,
+    ToolRuleSchema,
+    ToolSchema,
     ToolType,
     UpdateAssistantMessage,
     UpdateAssistantMessageContent,
@@ -593,7 +603,12 @@ from .templates import (
     TemplatesCreateAgentsResponseAgentsItemUpdatedAt,
     TemplatesCreateAgentsResponseAgentsItemUpdatedAtItem,
 )
-from .tools import ListMcpServersResponseValue
+from .tools import (
+    AddMcpServerRequest,
+    AddMcpServerResponseItem,
+    DeleteMcpServerResponseItem,
+    ListMcpServersResponseValue,
+)
 from .version import __version__
 from .voice import CreateVoiceChatCompletionsRequest
 
@@ -601,7 +616,10 @@ __all__ = [
     "ActionModel",
     "ActionParametersModel",
     "ActionResponseModel",
+    "AddMcpServerRequest",
+    "AddMcpServerResponseItem",
     "AgentEnvironmentVariable",
+    "AgentSchema",
     "AgentState",
     "AgentStateToolRulesItem",
     "AgentType",
@@ -863,9 +881,11 @@ __all__ = [
     "ConflictErrorBody",
     "ContextWindowOverview",
     "ContinueToolRule",
+    "CoreMemoryBlockSchema",
     "CreateAgentRequestToolRulesItem",
     "CreateBlock",
     "CreateVoiceChatCompletionsRequest",
+    "DeleteMcpServerResponseItem",
     "DynamicManager",
     "E2BSandboxConfig",
     "EmbeddingConfig",
@@ -912,7 +932,6 @@ __all__ = [
     "LlmConfig",
     "LlmConfigModelEndpointType",
     "LocalSandboxConfig",
-    "LocalServerConfig",
     "ManagerType",
     "McpServerType",
     "McpTool",
@@ -922,6 +941,7 @@ __all__ = [
     "MessageCreateContent",
     "MessageCreateRole",
     "MessageRole",
+    "MessageSchema",
     "NotFoundError",
     "NotFoundErrorBody",
     "NotFoundErrorBodyMessage",
@@ -930,6 +950,8 @@ __all__ = [
     "OpenaiTypesChatCompletionCreateParamsFunction",
     "Organization",
     "OrganizationCreate",
+    "ParameterProperties",
+    "ParametersSchema",
     "Passage",
     "PipRequirement",
     "Provider",
@@ -950,10 +972,12 @@ __all__ = [
     "SandboxType",
     "Source",
     "SseServerConfig",
+    "StdioServerConfig",
     "Step",
     "SupervisorManager",
     "SystemMessage",
     "SystemMessageContent",
+    "TagSchema",
     "TemplatesCreateAgentsResponse",
     "TemplatesCreateAgentsResponseAgentsItem",
     "TemplatesCreateAgentsResponseAgentsItemAgentType",
@@ -1148,10 +1172,14 @@ __all__ = [
     "ToolCallMessage",
     "ToolCallMessageToolCall",
     "ToolCreate",
+    "ToolEnvVarSchema",
+    "ToolJsonSchema",
     "ToolReturn",
     "ToolReturnMessage",
     "ToolReturnMessageStatus",
     "ToolReturnStatus",
+    "ToolRuleSchema",
+    "ToolSchema",
     "ToolType",
     "UnprocessableEntityError",
     "UpdateAgentToolRulesItem",

{letta_client-0.1.68 → letta_client-0.1.70}/src/letta_client/agents/client.py

@@ -25,6 +25,7 @@ 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 ..types.agent_schema import AgentSchema
 from ..core.jsonable_encoder import jsonable_encoder
 from .. import core
 from .types.update_agent_tool_rules_item import UpdateAgentToolRulesItem
@@ -422,11 +423,11 @@ class AgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def download_agent_serialized(
+    def export_agent_serialized(
         self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Optional[typing.Any]:
+    ) -> AgentSchema:
         """
-        Download the serialized JSON representation of an agent.
+        Export the serialized JSON representation of an agent.
 
         Parameters
         ----------
@@ -437,7 +438,7 @@ class AgentsClient:
 
         Returns
         -------
-        typing.Optional[typing.Any]
+        AgentSchema
             Successful Response
 
         Examples
@@ -447,21 +448,21 @@ class AgentsClient:
         client = Letta(
             token="YOUR_TOKEN",
         )
-        client.agents.download_agent_serialized(
+        client.agents.export_agent_serialized(
             agent_id="agent_id",
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/download",
+            f"v1/agents/{jsonable_encoder(agent_id)}/export",
             method="GET",
             request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    typing.Optional[typing.Any],
+                    AgentSchema,
                     construct_type(
-                        type_=typing.Optional[typing.Any],  # type: ignore
+                        type_=AgentSchema,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -480,7 +481,7 @@ class AgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def upload_agent_serialized(
+    def import_agent_serialized(
         self,
         *,
         file: core.File,
@@ -490,7 +491,7 @@ class AgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
-        Upload a serialized agent JSON file and recreate the agent in the system.
+        Import a serialized agent file and recreate the agent in the system.
 
         Parameters
         ----------
@@ -521,10 +522,10 @@ class AgentsClient:
         client = Letta(
             token="YOUR_TOKEN",
         )
-        client.agents.upload_agent_serialized()
+        client.agents.import_agent_serialized()
         """
         _response = self._client_wrapper.httpx_client.request(
-            "v1/agents/upload",
+            "v1/agents/import",
             method="POST",
             params={
                 "append_copy_suffix": append_copy_suffix,
@@ -1514,11 +1515,11 @@ class AsyncAgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def download_agent_serialized(
+    async def export_agent_serialized(
         self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Optional[typing.Any]:
+    ) -> AgentSchema:
         """
-        Download the serialized JSON representation of an agent.
+        Export the serialized JSON representation of an agent.
 
         Parameters
         ----------
@@ -1529,7 +1530,7 @@ class AsyncAgentsClient:
 
         Returns
         -------
-        typing.Optional[typing.Any]
+        AgentSchema
             Successful Response
 
         Examples
@@ -1544,7 +1545,7 @@ class AsyncAgentsClient:
 
 
         async def main() -> None:
-            await client.agents.download_agent_serialized(
+            await client.agents.export_agent_serialized(
                 agent_id="agent_id",
             )
 
@@ -1552,16 +1553,16 @@ class AsyncAgentsClient:
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/download",
+            f"v1/agents/{jsonable_encoder(agent_id)}/export",
             method="GET",
             request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    typing.Optional[typing.Any],
+                    AgentSchema,
                     construct_type(
-                        type_=typing.Optional[typing.Any],  # type: ignore
+                        type_=AgentSchema,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -1580,7 +1581,7 @@ class AsyncAgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def upload_agent_serialized(
+    async def import_agent_serialized(
         self,
         *,
         file: core.File,
@@ -1590,7 +1591,7 @@ class AsyncAgentsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
-        Upload a serialized agent JSON file and recreate the agent in the system.
+        Import a serialized agent file and recreate the agent in the system.
 
         Parameters
         ----------
@@ -1626,13 +1627,13 @@ class AsyncAgentsClient:
 
 
         async def main() -> None:
-            await client.agents.upload_agent_serialized()
+            await client.agents.import_agent_serialized()
 
 
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            "v1/agents/upload",
+            "v1/agents/import",
             method="POST",
             params={
                 "append_copy_suffix": append_copy_suffix,

{letta_client-0.1.68 → letta_client-0.1.70}/src/letta_client/core/client_wrapper.py

@@ -16,7 +16,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.68",
+            "X-Fern-SDK-Version": "0.1.70",
         }
         if self.token is not None:
             headers["Authorization"] = f"Bearer {self.token}"

letta_client-0.1.70/src/letta_client/tools/__init__.py

@@ -0,0 +1,15 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .types import (
+    AddMcpServerRequest,
+    AddMcpServerResponseItem,
+    DeleteMcpServerResponseItem,
+    ListMcpServersResponseValue,
+)
+
+__all__ = [
+    "AddMcpServerRequest",
+    "AddMcpServerResponseItem",
+    "DeleteMcpServerResponseItem",
+    "ListMcpServersResponseValue",
+]

{letta_client-0.1.68 → letta_client-0.1.70}/src/letta_client/tools/client.py

@@ -14,7 +14,11 @@ from ..types.tool_return_message import ToolReturnMessage
 from ..types.app_model import AppModel
 from ..types.action_model import ActionModel
 from .types.list_mcp_servers_response_value import ListMcpServersResponseValue
+from .types.add_mcp_server_request import AddMcpServerRequest
+from .types.add_mcp_server_response_item import AddMcpServerResponseItem
+from ..core.serialization import convert_and_respect_annotation_metadata
 from ..types.mcp_tool import McpTool
+from .types.delete_mcp_server_response_item import DeleteMcpServerResponseItem
 from ..core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -872,6 +876,72 @@ class ToolsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def add_mcp_server(
+        self, *, request: AddMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[AddMcpServerResponseItem]:
+        """
+        Add a new MCP server to the Letta MCP server config
+
+        Parameters
+        ----------
+        request : AddMcpServerRequest
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[AddMcpServerResponseItem]
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta, StdioServerConfig
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.tools.add_mcp_server(
+            request=StdioServerConfig(
+                server_name="server_name",
+                command="command",
+                args=["args"],
+            ),
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/tools/mcp/servers",
+            method="PUT",
+            json=convert_and_respect_annotation_metadata(
+                object_=request, annotation=AddMcpServerRequest, direction="write"
+            ),
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[AddMcpServerResponseItem],
+                    construct_type(
+                        type_=typing.List[AddMcpServerResponseItem],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     def list_mcp_tools_by_server(
         self, mcp_server_name: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.List[McpTool]:
@@ -934,7 +1004,7 @@ class ToolsClient:
         self, mcp_server_name: str, mcp_tool_name: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> Tool:
         """
-        Add a new MCP tool by server + tool name
+        Register a new MCP tool as a Letta server by MCP server + tool name
 
         Parameters
         ----------
@@ -991,6 +1061,64 @@ class ToolsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def delete_mcp_server(
+        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
+
+        Parameters
+        ----------
+        mcp_server_name : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[DeleteMcpServerResponseItem]
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.tools.delete_mcp_server(
+            mcp_server_name="mcp_server_name",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/tools/mcp/servers/{jsonable_encoder(mcp_server_name)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[DeleteMcpServerResponseItem],
+                    construct_type(
+                        type_=typing.List[DeleteMcpServerResponseItem],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
 
 class AsyncToolsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -1941,6 +2069,80 @@ class AsyncToolsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    async def add_mcp_server(
+        self, *, request: AddMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[AddMcpServerResponseItem]:
+        """
+        Add a new MCP server to the Letta MCP server config
+
+        Parameters
+        ----------
+        request : AddMcpServerRequest
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[AddMcpServerResponseItem]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta, StdioServerConfig
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tools.add_mcp_server(
+                request=StdioServerConfig(
+                    server_name="server_name",
+                    command="command",
+                    args=["args"],
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/tools/mcp/servers",
+            method="PUT",
+            json=convert_and_respect_annotation_metadata(
+                object_=request, annotation=AddMcpServerRequest, direction="write"
+            ),
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[AddMcpServerResponseItem],
+                    construct_type(
+                        type_=typing.List[AddMcpServerResponseItem],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     async def list_mcp_tools_by_server(
         self, mcp_server_name: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.List[McpTool]:
@@ -2011,7 +2213,7 @@ class AsyncToolsClient:
         self, mcp_server_name: str, mcp_tool_name: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> Tool:
         """
-        Add a new MCP tool by server + tool name
+        Register a new MCP tool as a Letta server by MCP server + tool name
 
         Parameters
         ----------
@@ -2075,3 +2277,69 @@ class AsyncToolsClient:
         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_mcp_server(
+        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
+
+        Parameters
+        ----------
+        mcp_server_name : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[DeleteMcpServerResponseItem]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tools.delete_mcp_server(
+                mcp_server_name="mcp_server_name",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/tools/mcp/servers/{jsonable_encoder(mcp_server_name)}",
+            method="DELETE",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[DeleteMcpServerResponseItem],
+                    construct_type(
+                        type_=typing.List[DeleteMcpServerResponseItem],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)