letta-client 0.1.221__tar.gz → 0.1.222__tar.gz

{letta_client-0.1.221 → letta_client-0.1.222}/PKG-INFO

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

{letta_client-0.1.221 → letta_client-0.1.222}/pyproject.toml

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

{letta_client-0.1.221 → letta_client-0.1.222}/src/letta_client/__init__.py

@@ -334,6 +334,7 @@ from .templates import TemplatesListResponse, TemplatesListResponseTemplatesItem
 from .tools import (
     AddMcpServerRequest,
     AddMcpServerResponseItem,
+    ConnectMcpServerRequest,
     DeleteMcpServerResponseItem,
     ListMcpServersResponseValue,
     TestMcpServerRequest,
@@ -449,6 +450,7 @@ __all__ = [
     "ConditionalToolRuleSchema",
     "ConflictError",
     "ConflictErrorBody",
+    "ConnectMcpServerRequest",
     "ContextWindowOverview",
     "ContinueToolRule",
     "CoreMemoryBlockSchema",

{letta_client-0.1.221 → letta_client-0.1.222}/src/letta_client/core/client_wrapper.py

@@ -24,7 +24,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.221",
+            "X-Fern-SDK-Version": "0.1.222",
         }
         if self._project is not None:
             headers["X-Project"] = self._project

{letta_client-0.1.221 → letta_client-0.1.222}/src/letta_client/tools/__init__.py

@@ -3,6 +3,7 @@
 from .types import (
     AddMcpServerRequest,
     AddMcpServerResponseItem,
+    ConnectMcpServerRequest,
     DeleteMcpServerResponseItem,
     ListMcpServersResponseValue,
     TestMcpServerRequest,
@@ -13,6 +14,7 @@ from .types import (
 __all__ = [
     "AddMcpServerRequest",
     "AddMcpServerResponseItem",
+    "ConnectMcpServerRequest",
     "DeleteMcpServerResponseItem",
     "ListMcpServersResponseValue",
     "TestMcpServerRequest",

{letta_client-0.1.221 → letta_client-0.1.222}/src/letta_client/tools/client.py

@@ -23,6 +23,7 @@ from .types.delete_mcp_server_response_item import DeleteMcpServerResponseItem
 from .types.update_mcp_server_request import UpdateMcpServerRequest
 from .types.update_mcp_server_response import UpdateMcpServerResponse
 from .types.test_mcp_server_request import TestMcpServerRequest
+from .types.connect_mcp_server_request import ConnectMcpServerRequest
 from ..core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -1320,10 +1321,10 @@ class ToolsClient:
 
     def test_mcp_server(
         self, *, request: TestMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.List[McpTool]:
+    ) -> typing.Optional[typing.Any]:
         """
         Test connection to an MCP server without adding it.
-        Returns the list of available tools if successful.
+        Returns the list of available tools if successful, or OAuth information if OAuth is required.
 
         Parameters
         ----------
@@ -1334,7 +1335,7 @@ class ToolsClient:
 
         Returns
         -------
-        typing.List[McpTool]
+        typing.Optional[typing.Any]
             Successful Response
 
         Examples
@@ -1365,9 +1366,77 @@ class ToolsClient:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    typing.List[McpTool],
+                    typing.Optional[typing.Any],
                     construct_type(
-                        type_=typing.List[McpTool],  # type: ignore
+                        type_=typing.Optional[typing.Any],  # 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 connect_mcp_server(
+        self, *, request: ConnectMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.Optional[typing.Any]:
+        """
+        Connect to an MCP server with support for OAuth via SSE.
+        Returns a stream of events handling authorization state and exchange if OAuth is required.
+
+        Parameters
+        ----------
+        request : ConnectMcpServerRequest
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Optional[typing.Any]
+            Successful response
+
+        Examples
+        --------
+        from letta_client import Letta, StdioServerConfig
+
+        client = Letta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+        client.tools.connect_mcp_server(
+            request=StdioServerConfig(
+                server_name="server_name",
+                command="command",
+                args=["args"],
+            ),
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/tools/mcp/servers/connect",
+            method="POST",
+            json=convert_and_respect_annotation_metadata(
+                object_=request, annotation=ConnectMcpServerRequest, direction="write"
+            ),
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Optional[typing.Any],
+                    construct_type(
+                        type_=typing.Optional[typing.Any],  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -1386,6 +1455,83 @@ class ToolsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def mcp_oauth_callback(
+        self,
+        session_id: str,
+        *,
+        code: typing.Optional[str] = None,
+        state: typing.Optional[str] = None,
+        error: typing.Optional[str] = None,
+        error_description: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> None:
+        """
+        Handle OAuth callback for MCP server authentication.
+
+        Parameters
+        ----------
+        session_id : str
+
+        code : typing.Optional[str]
+            OAuth authorization code
+
+        state : typing.Optional[str]
+            OAuth state parameter
+
+        error : typing.Optional[str]
+            OAuth error
+
+        error_description : typing.Optional[str]
+            OAuth error description
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+        client.tools.mcp_oauth_callback(
+            session_id="session_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/tools/mcp/oauth/callback/{jsonable_encoder(session_id)}",
+            method="GET",
+            params={
+                "code": code,
+                "state": state,
+                "error": error,
+                "error_description": error_description,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return
+            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):
@@ -2822,10 +2968,10 @@ class AsyncToolsClient:
 
     async def test_mcp_server(
         self, *, request: TestMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.List[McpTool]:
+    ) -> typing.Optional[typing.Any]:
         """
         Test connection to an MCP server without adding it.
-        Returns the list of available tools if successful.
+        Returns the list of available tools if successful, or OAuth information if OAuth is required.
 
         Parameters
         ----------
@@ -2836,7 +2982,7 @@ class AsyncToolsClient:
 
         Returns
         -------
-        typing.List[McpTool]
+        typing.Optional[typing.Any]
             Successful Response
 
         Examples
@@ -2875,9 +3021,9 @@ class AsyncToolsClient:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    typing.List[McpTool],
+                    typing.Optional[typing.Any],
                     construct_type(
-                        type_=typing.List[McpTool],  # type: ignore
+                        type_=typing.Optional[typing.Any],  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -2895,3 +3041,164 @@ 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 connect_mcp_server(
+        self, *, request: ConnectMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.Optional[typing.Any]:
+        """
+        Connect to an MCP server with support for OAuth via SSE.
+        Returns a stream of events handling authorization state and exchange if OAuth is required.
+
+        Parameters
+        ----------
+        request : ConnectMcpServerRequest
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Optional[typing.Any]
+            Successful response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta, StdioServerConfig
+
+        client = AsyncLetta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tools.connect_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/connect",
+            method="POST",
+            json=convert_and_respect_annotation_metadata(
+                object_=request, annotation=ConnectMcpServerRequest, direction="write"
+            ),
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Optional[typing.Any],
+                    construct_type(
+                        type_=typing.Optional[typing.Any],  # 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 mcp_oauth_callback(
+        self,
+        session_id: str,
+        *,
+        code: typing.Optional[str] = None,
+        state: typing.Optional[str] = None,
+        error: typing.Optional[str] = None,
+        error_description: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> None:
+        """
+        Handle OAuth callback for MCP server authentication.
+
+        Parameters
+        ----------
+        session_id : str
+
+        code : typing.Optional[str]
+            OAuth authorization code
+
+        state : typing.Optional[str]
+            OAuth state parameter
+
+        error : typing.Optional[str]
+            OAuth error
+
+        error_description : typing.Optional[str]
+            OAuth error description
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tools.mcp_oauth_callback(
+                session_id="session_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/tools/mcp/oauth/callback/{jsonable_encoder(session_id)}",
+            method="GET",
+            params={
+                "code": code,
+                "state": state,
+                "error": error,
+                "error_description": error_description,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return
+            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)

{letta_client-0.1.221 → letta_client-0.1.222}/src/letta_client/tools/types/__init__.py

@@ -2,6 +2,7 @@
 
 from .add_mcp_server_request import AddMcpServerRequest
 from .add_mcp_server_response_item import AddMcpServerResponseItem
+from .connect_mcp_server_request import ConnectMcpServerRequest
 from .delete_mcp_server_response_item import DeleteMcpServerResponseItem
 from .list_mcp_servers_response_value import ListMcpServersResponseValue
 from .test_mcp_server_request import TestMcpServerRequest
@@ -11,6 +12,7 @@ from .update_mcp_server_response import UpdateMcpServerResponse
 __all__ = [
     "AddMcpServerRequest",
     "AddMcpServerResponseItem",
+    "ConnectMcpServerRequest",
     "DeleteMcpServerResponseItem",
     "ListMcpServersResponseValue",
     "TestMcpServerRequest",

letta_client-0.1.222/src/letta_client/tools/types/connect_mcp_server_request.py

@@ -0,0 +1,8 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from ...types.stdio_server_config import StdioServerConfig
+from ...types.sse_server_config import SseServerConfig
+from ...types.streamable_http_server_config import StreamableHttpServerConfig
+
+ConnectMcpServerRequest = typing.Union[StdioServerConfig, SseServerConfig, StreamableHttpServerConfig]