letta-client 0.1.225__tar.gz → 0.1.226__tar.gz

{letta_client-0.1.225 → letta_client-0.1.226}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: letta-client
-Version: 0.1.225
+Version: 0.1.226
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers
@@ -102,24 +102,18 @@ except ApiError as e:
 The SDK supports streaming responses, as well, the response will be a generator that you can loop over.
 
 ```python
-from letta_client import Letta, MessageCreate, TextContent
+from letta_client import Letta, StdioServerConfig
 
 client = Letta(
     project="YOUR_PROJECT",
     token="YOUR_TOKEN",
 )
-response = client.agents.messages.create_stream(
-    agent_id="agent_id",
-    messages=[
-        MessageCreate(
-            role="user",
-            content=[
-                TextContent(
-                    text="text",
-                )
-            ],
-        )
-    ],
+response = client.tools.connect_mcp_server(
+    request=StdioServerConfig(
+        server_name="server_name",
+        command="command",
+        args=["args"],
+    ),
 )
 for chunk in response:
     yield chunk

{letta_client-0.1.225 → letta_client-0.1.226}/README.md

@@ -75,24 +75,18 @@ except ApiError as e:
 The SDK supports streaming responses, as well, the response will be a generator that you can loop over.
 
 ```python
-from letta_client import Letta, MessageCreate, TextContent
+from letta_client import Letta, StdioServerConfig
 
 client = Letta(
     project="YOUR_PROJECT",
     token="YOUR_TOKEN",
 )
-response = client.agents.messages.create_stream(
-    agent_id="agent_id",
-    messages=[
-        MessageCreate(
-            role="user",
-            content=[
-                TextContent(
-                    text="text",
-                )
-            ],
-        )
-    ],
+response = client.tools.connect_mcp_server(
+    request=StdioServerConfig(
+        server_name="server_name",
+        command="command",
+        args=["args"],
+    ),
 )
 for chunk in response:
     yield chunk

{letta_client-0.1.225 → letta_client-0.1.226}/pyproject.toml

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

{letta_client-0.1.225 → letta_client-0.1.226}/src/letta_client/__init__.py

@@ -335,8 +335,10 @@ from .tools import (
     AddMcpServerRequest,
     AddMcpServerResponseItem,
     ConnectMcpServerRequest,
+    ConnectMcpServerResponseEvent,
     DeleteMcpServerResponseItem,
     ListMcpServersResponseValue,
+    StreamingResponse,
     TestMcpServerRequest,
     UpdateMcpServerRequest,
     UpdateMcpServerResponse,
@@ -451,6 +453,7 @@ __all__ = [
     "ConflictError",
     "ConflictErrorBody",
     "ConnectMcpServerRequest",
+    "ConnectMcpServerResponseEvent",
     "ContextWindowOverview",
     "ContinueToolRule",
     "CoreMemoryBlockSchema",
@@ -597,6 +600,7 @@ __all__ = [
     "StepsListRequestFeedback",
     "StopReasonType",
     "StreamableHttpServerConfig",
+    "StreamingResponse",
     "SupervisorManager",
     "SupervisorManagerUpdate",
     "SystemMessage",

{letta_client-0.1.225 → letta_client-0.1.226}/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.225",
+            "X-Fern-SDK-Version": "0.1.226",
         }
         if self._project is not None:
             headers["X-Project"] = self._project

{letta_client-0.1.225 → letta_client-0.1.226}/src/letta_client/tools/__init__.py

@@ -4,8 +4,10 @@ from .types import (
     AddMcpServerRequest,
     AddMcpServerResponseItem,
     ConnectMcpServerRequest,
+    ConnectMcpServerResponseEvent,
     DeleteMcpServerResponseItem,
     ListMcpServersResponseValue,
+    StreamingResponse,
     TestMcpServerRequest,
     UpdateMcpServerRequest,
     UpdateMcpServerResponse,
@@ -15,8 +17,10 @@ __all__ = [
     "AddMcpServerRequest",
     "AddMcpServerResponseItem",
     "ConnectMcpServerRequest",
+    "ConnectMcpServerResponseEvent",
     "DeleteMcpServerResponseItem",
     "ListMcpServersResponseValue",
+    "StreamingResponse",
     "TestMcpServerRequest",
     "UpdateMcpServerRequest",
     "UpdateMcpServerResponse",

{letta_client-0.1.225 → letta_client-0.1.226}/src/letta_client/tools/client.py

@@ -24,6 +24,9 @@ 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 .types.streaming_response import StreamingResponse
+import httpx_sse
+import json
 from ..core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -1324,7 +1327,7 @@ class ToolsClient:
     ) -> typing.Optional[typing.Any]:
         """
         Test connection to an MCP server without adding it.
-        Returns the list of available tools if successful, or OAuth information if OAuth is required.
+        Returns the list of available tools if successful.
 
         Parameters
         ----------
@@ -1389,7 +1392,7 @@ class ToolsClient:
 
     def connect_mcp_server(
         self, *, request: ConnectMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Optional[typing.Any]:
+    ) -> typing.Iterator[StreamingResponse]:
         """
         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.
@@ -1401,9 +1404,9 @@ class ToolsClient:
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
-        Returns
-        -------
-        typing.Optional[typing.Any]
+        Yields
+        ------
+        typing.Iterator[StreamingResponse]
             Successful response
 
         Examples
@@ -1414,15 +1417,17 @@ class ToolsClient:
             project="YOUR_PROJECT",
             token="YOUR_TOKEN",
         )
-        client.tools.connect_mcp_server(
+        response = client.tools.connect_mcp_server(
             request=StdioServerConfig(
                 server_name="server_name",
                 command="command",
                 args=["args"],
             ),
         )
+        for chunk in response:
+            yield chunk
         """
-        _response = self._client_wrapper.httpx_client.request(
+        with self._client_wrapper.httpx_client.stream(
             "v1/tools/mcp/servers/connect",
             method="POST",
             json=convert_and_respect_annotation_metadata(
@@ -1430,107 +1435,37 @@ class ToolsClient:
             ),
             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(),
-                        ),
+        ) as _response:
+            try:
+                if 200 <= _response.status_code < 300:
+                    _event_source = httpx_sse.EventSource(_response)
+                    for _sse in _event_source.iter_sse():
+                        try:
+                            yield typing.cast(
+                                StreamingResponse,
+                                construct_type(
+                                    type_=StreamingResponse,  # type: ignore
+                                    object_=json.loads(_sse.data),
+                                ),
+                            )
+                        except:
+                            pass
+                    return
+                _response.read()
+                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 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)
+                _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:
@@ -2971,7 +2906,7 @@ class AsyncToolsClient:
     ) -> typing.Optional[typing.Any]:
         """
         Test connection to an MCP server without adding it.
-        Returns the list of available tools if successful, or OAuth information if OAuth is required.
+        Returns the list of available tools if successful.
 
         Parameters
         ----------
@@ -3044,7 +2979,7 @@ class AsyncToolsClient:
 
     async def connect_mcp_server(
         self, *, request: ConnectMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Optional[typing.Any]:
+    ) -> typing.AsyncIterator[StreamingResponse]:
         """
         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.
@@ -3056,9 +2991,9 @@ class AsyncToolsClient:
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
-        Returns
-        -------
-        typing.Optional[typing.Any]
+        Yields
+        ------
+        typing.AsyncIterator[StreamingResponse]
             Successful response
 
         Examples
@@ -3074,18 +3009,20 @@ class AsyncToolsClient:
 
 
         async def main() -> None:
-            await client.tools.connect_mcp_server(
+            response = await client.tools.connect_mcp_server(
                 request=StdioServerConfig(
                     server_name="server_name",
                     command="command",
                     args=["args"],
                 ),
             )
+            async for chunk in response:
+                yield chunk
 
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
+        async with self._client_wrapper.httpx_client.stream(
             "v1/tools/mcp/servers/connect",
             method="POST",
             json=convert_and_respect_annotation_metadata(
@@ -3093,112 +3030,34 @@ class AsyncToolsClient:
             ),
             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(),
-                        ),
+        ) as _response:
+            try:
+                if 200 <= _response.status_code < 300:
+                    _event_source = httpx_sse.EventSource(_response)
+                    async for _sse in _event_source.aiter_sse():
+                        try:
+                            yield typing.cast(
+                                StreamingResponse,
+                                construct_type(
+                                    type_=StreamingResponse,  # type: ignore
+                                    object_=json.loads(_sse.data),
+                                ),
+                            )
+                        except:
+                            pass
+                    return
+                await _response.aread()
+                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)
+                _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.225 → letta_client-0.1.226}/src/letta_client/tools/types/__init__.py

@@ -3,8 +3,10 @@
 from .add_mcp_server_request import AddMcpServerRequest
 from .add_mcp_server_response_item import AddMcpServerResponseItem
 from .connect_mcp_server_request import ConnectMcpServerRequest
+from .connect_mcp_server_response_event import ConnectMcpServerResponseEvent
 from .delete_mcp_server_response_item import DeleteMcpServerResponseItem
 from .list_mcp_servers_response_value import ListMcpServersResponseValue
+from .streaming_response import StreamingResponse
 from .test_mcp_server_request import TestMcpServerRequest
 from .update_mcp_server_request import UpdateMcpServerRequest
 from .update_mcp_server_response import UpdateMcpServerResponse
@@ -13,8 +15,10 @@ __all__ = [
     "AddMcpServerRequest",
     "AddMcpServerResponseItem",
     "ConnectMcpServerRequest",
+    "ConnectMcpServerResponseEvent",
     "DeleteMcpServerResponseItem",
     "ListMcpServersResponseValue",
+    "StreamingResponse",
     "TestMcpServerRequest",
     "UpdateMcpServerRequest",
     "UpdateMcpServerResponse",

letta_client-0.1.226/src/letta_client/tools/types/connect_mcp_server_response_event.py

@@ -0,0 +1,8 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+ConnectMcpServerResponseEvent = typing.Union[
+    typing.Literal["connection_attempt", "success", "error", "oauth_required", "authorization_url", "waiting_for_auth"],
+    typing.Any,
+]

letta_client-0.1.226/src/letta_client/tools/types/streaming_response.py

@@ -0,0 +1,23 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.unchecked_base_model import UncheckedBaseModel
+from .connect_mcp_server_response_event import ConnectMcpServerResponseEvent
+import typing
+from ...types.mcp_tool import McpTool
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class StreamingResponse(UncheckedBaseModel):
+    event: ConnectMcpServerResponseEvent
+    message: typing.Optional[str] = None
+    tools: typing.Optional[McpTool] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow