letta-client 0.1.232__py3-none-any.whl → 0.1.234__py3-none-any.whl

letta_client/types/usage_statistics.py

@@ -1,11 +1,12 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
-from .usage_statistics_prompt_token_details import UsageStatisticsPromptTokenDetails
-from .usage_statistics_completion_token_details import UsageStatisticsCompletionTokenDetails
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
 import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .usage_statistics_completion_token_details import UsageStatisticsCompletionTokenDetails
+from .usage_statistics_prompt_token_details import UsageStatisticsPromptTokenDetails
 
 
 class UsageStatistics(UncheckedBaseModel):

letta_client/types/usage_statistics_completion_token_details.py

@@ -1,9 +1,10 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
 import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
 
 
 class UsageStatisticsCompletionTokenDetails(UncheckedBaseModel):

letta_client/types/usage_statistics_prompt_token_details.py

@@ -1,9 +1,10 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
 import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
 
 
 class UsageStatisticsPromptTokenDetails(UncheckedBaseModel):

letta_client/types/user.py

@@ -1,10 +1,11 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
+import datetime as dt
 import typing
+
 import pydantic
-import datetime as dt
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
 
 
 class User(UncheckedBaseModel):

letta_client/types/user_create.py

@@ -1,9 +1,10 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
-import typing
+from ..core.unchecked_base_model import UncheckedBaseModel
 
 
 class UserCreate(UncheckedBaseModel):

letta_client/types/user_message.py

@@ -1,11 +1,12 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
 import datetime as dt
 import typing
-from .user_message_content import UserMessageContent
+
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .user_message_content import UserMessageContent
 
 
 class UserMessage(UncheckedBaseModel):

letta_client/types/user_message_content.py

@@ -1,6 +1,7 @@
 # This file was auto-generated by Fern from our API Definition.
 
 import typing
+
 from .letta_user_message_content_union import LettaUserMessageContentUnion
 
 UserMessageContent = typing.Union[typing.List[LettaUserMessageContentUnion], str]

letta_client/types/user_update.py

@@ -1,9 +1,10 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
-import pydantic
 import typing
+
+import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
 
 
 class UserUpdate(UncheckedBaseModel):

letta_client/types/validation_error.py

@@ -1,10 +1,11 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
-from .validation_error_loc_item import ValidationErrorLocItem
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
 import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .validation_error_loc_item import ValidationErrorLocItem
 
 
 class ValidationError(UncheckedBaseModel):

letta_client/types/voice_sleeptime_manager.py

@@ -1,9 +1,10 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
+
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
 
 
 class VoiceSleeptimeManager(UncheckedBaseModel):

letta_client/types/voice_sleeptime_manager_update.py

@@ -1,9 +1,10 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
+
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
 
 
 class VoiceSleeptimeManagerUpdate(UncheckedBaseModel):

letta_client/types/web_search_options.py

@@ -1,11 +1,12 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
 from .web_search_options_search_context_size import WebSearchOptionsSearchContextSize
 from .web_search_options_user_location import WebSearchOptionsUserLocation
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-import pydantic
 
 
 class WebSearchOptions(UncheckedBaseModel):

letta_client/types/web_search_options_user_location.py

@@ -1,10 +1,11 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
-from .web_search_options_user_location_approximate import WebSearchOptionsUserLocationApproximate
 import typing
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
 import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .web_search_options_user_location_approximate import WebSearchOptionsUserLocationApproximate
 
 
 class WebSearchOptionsUserLocation(UncheckedBaseModel):

letta_client/types/web_search_options_user_location_approximate.py

@@ -1,9 +1,10 @@
 # This file was auto-generated by Fern from our API Definition.
 
-from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
 import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
 
 
 class WebSearchOptionsUserLocationApproximate(UncheckedBaseModel):

letta_client/voice/__init__.py

@@ -1,2 +1,4 @@
 # This file was auto-generated by Fern from our API Definition.
 
+# isort: skip_file
+

letta_client/voice/client.py

@@ -1,15 +1,10 @@
 # This file was auto-generated by Fern from our API Definition.
 
 import typing
-from ..core.client_wrapper import SyncClientWrapper
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
-from ..core.jsonable_encoder import jsonable_encoder
-from ..core.unchecked_base_model import construct_type
-from ..errors.unprocessable_entity_error import UnprocessableEntityError
-from ..types.http_validation_error import HttpValidationError
-from json.decoder import JSONDecodeError
-from ..core.api_error import ApiError
-from ..core.client_wrapper import AsyncClientWrapper
+from .raw_client import AsyncRawVoiceClient, RawVoiceClient
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -17,7 +12,18 @@ OMIT = typing.cast(typing.Any, ...)
 
 class VoiceClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = RawVoiceClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawVoiceClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawVoiceClient
+        """
+        return self._raw_client
 
     def create_voice_chat_completions(
         self,
@@ -57,44 +63,26 @@ class VoiceClient:
             request={"key": "value"},
         )
         """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/voice-beta/{jsonable_encoder(agent_id)}/chat/completions",
-            method="POST",
-            json=request,
-            headers={
-                "user-id": str(user_id) if user_id is not None else None,
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = self._raw_client.create_voice_chat_completions(
+            agent_id, request=request, user_id=user_id, request_options=request_options
         )
-        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)
+        return _response.data
 
 
 class AsyncVoiceClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
+        self._raw_client = AsyncRawVoiceClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawVoiceClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawVoiceClient
+        """
+        return self._raw_client
 
     async def create_voice_chat_completions(
         self,
@@ -142,36 +130,7 @@ class AsyncVoiceClient:
 
         asyncio.run(main())
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/voice-beta/{jsonable_encoder(agent_id)}/chat/completions",
-            method="POST",
-            json=request,
-            headers={
-                "user-id": str(user_id) if user_id is not None else None,
-            },
-            request_options=request_options,
-            omit=OMIT,
+        _response = await self._raw_client.create_voice_chat_completions(
+            agent_id, request=request, user_id=user_id, request_options=request_options
         )
-        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)
+        return _response.data

letta_client/voice/raw_client.py

@@ -0,0 +1,154 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.http_response import AsyncHttpResponse, HttpResponse
+from ..core.jsonable_encoder import jsonable_encoder
+from ..core.request_options import RequestOptions
+from ..core.unchecked_base_model import construct_type
+from ..errors.unprocessable_entity_error import UnprocessableEntityError
+from ..types.http_validation_error import HttpValidationError
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class RawVoiceClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def create_voice_chat_completions(
+        self,
+        agent_id: str,
+        *,
+        request: typing.Dict[str, typing.Optional[typing.Any]],
+        user_id: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[typing.Optional[typing.Any]]:
+        """
+        Parameters
+        ----------
+        agent_id : str
+
+        request : typing.Dict[str, typing.Optional[typing.Any]]
+
+        user_id : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[typing.Optional[typing.Any]]
+            Successful response
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/voice-beta/{jsonable_encoder(agent_id)}/chat/completions",
+            method="POST",
+            json=request,
+            headers={
+                "content-type": "application/json",
+                "user-id": str(user_id) if user_id is not None else None,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if _response is None or not _response.text.strip():
+                return HttpResponse(response=_response, data=None)
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    typing.Optional[typing.Any],
+                    construct_type(
+                        type_=typing.Optional[typing.Any],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=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, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawVoiceClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def create_voice_chat_completions(
+        self,
+        agent_id: str,
+        *,
+        request: typing.Dict[str, typing.Optional[typing.Any]],
+        user_id: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[typing.Optional[typing.Any]]:
+        """
+        Parameters
+        ----------
+        agent_id : str
+
+        request : typing.Dict[str, typing.Optional[typing.Any]]
+
+        user_id : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[typing.Optional[typing.Any]]
+            Successful response
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/voice-beta/{jsonable_encoder(agent_id)}/chat/completions",
+            method="POST",
+            json=request,
+            headers={
+                "content-type": "application/json",
+                "user-id": str(user_id) if user_id is not None else None,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if _response is None or not _response.text.strip():
+                return AsyncHttpResponse(response=_response, data=None)
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    typing.Optional[typing.Any],
+                    construct_type(
+                        type_=typing.Optional[typing.Any],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=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, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

{letta_client-0.1.232.dist-info → letta_client-0.1.234.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: letta-client
-Version: 0.1.232
+Version: 0.1.234
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers
@@ -21,7 +21,7 @@ Classifier: Typing :: Typed
 Requires-Dist: httpx (>=0.21.2)
 Requires-Dist: httpx-sse (==0.4.0)
 Requires-Dist: pydantic (>=1.9.2)
-Requires-Dist: pydantic-core (>=2.18.2,<3.0.0)
+Requires-Dist: pydantic-core (>=2.18.2)
 Requires-Dist: typing_extensions (>=4.0.0)
 Description-Content-Type: text/markdown
 
@@ -115,12 +115,32 @@ response = client.tools.connect_mcp_server(
         args=["args"],
     ),
 )
-for chunk in response:
+for chunk in response.data:
     yield chunk
 ```
 
 ## Advanced
 
+### Access Raw Response Data
+
+The SDK provides access to raw response data, including headers, through the `.with_raw_response` property.
+The `.with_raw_response` property returns a "raw" client that can be used to access the `.headers` and `.data` attributes.
+
+```python
+from letta_client import Letta
+
+client = Letta(
+    ...,
+)
+response = client.tools.with_raw_response.create(...)
+print(response.headers)  # access the response headers
+print(response.data)  # access the underlying object
+with client.tools.with_raw_response.connect_mcp_server(...) as response:
+    print(response.headers)  # access the response headers
+    for chunk in response.data:
+        print(chunk)  # access the underlying object(s)
+```
+
 ### Retries
 
 The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long
@@ -165,6 +185,7 @@ client.tools.create(..., request_options={
 
 You can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies
 and transports.
+
 ```python
 import httpx
 from letta_client import Letta