letta-client 0.1.226__py3-none-any.whl → 1.7.2__py3-none-any.whl

letta_client/types/user_create.py

@@ -1,22 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-from ..core.unchecked_base_model import UncheckedBaseModel
-import pydantic
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-import typing
-
-
-class UserCreate(UncheckedBaseModel):
-    name: str = pydantic.Field()
-    """
-    The name of the user.
-    """
-
-    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

letta_client/types/user_message.py

@@ -1,42 +0,0 @@
-# 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
-
-
-class UserMessage(UncheckedBaseModel):
-    """
-    A message sent by the user. Never streamed back on a response, only used for cursor pagination.
-
-    Args:
-        id (str): The ID of the message
-        date (datetime): The date the message was created in ISO format
-        name (Optional[str]): The name of the sender of the message
-        content (Union[str, List[LettaUserMessageContentUnion]]): The message content sent by the user (can be a string or an array of multi-modal content parts)
-    """
-
-    id: str
-    date: dt.datetime
-    name: typing.Optional[str] = None
-    message_type: typing.Literal["user_message"] = "user_message"
-    otid: typing.Optional[str] = None
-    sender_id: typing.Optional[str] = None
-    step_id: typing.Optional[str] = None
-    is_err: typing.Optional[bool] = None
-    content: UserMessageContent = pydantic.Field()
-    """
-    The message content sent by the user (can be a string or an array of multi-modal content parts)
-    """
-
-    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

letta_client/types/user_message_content.py

@@ -1,6 +0,0 @@
-# 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,27 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-from ..core.unchecked_base_model import UncheckedBaseModel
-import pydantic
-import typing
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class UserUpdate(UncheckedBaseModel):
-    id: str = pydantic.Field()
-    """
-    The id of the user to update.
-    """
-
-    name: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The new name of the user.
-    """
-
-    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

letta_client/types/validation_error.py

@@ -1,22 +0,0 @@
-# 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
-
-
-class ValidationError(UncheckedBaseModel):
-    loc: typing.List[ValidationErrorLocItem]
-    msg: str
-    type: str
-
-    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

letta_client/types/validation_error_loc_item.py

@@ -1,5 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-
-ValidationErrorLocItem = typing.Union[str, int]

letta_client/types/voice_sleeptime_manager.py

@@ -1,33 +0,0 @@
-# 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
-
-
-class VoiceSleeptimeManager(UncheckedBaseModel):
-    manager_type: typing.Literal["voice_sleeptime"] = "voice_sleeptime"
-    manager_agent_id: str = pydantic.Field()
-    """
-    
-    """
-
-    max_message_buffer_length: typing.Optional[int] = pydantic.Field(default=None)
-    """
-    The desired maximum length of messages in the context window of the convo agent. This is a best effort, and may be off slightly due to user/assistant interleaving.
-    """
-
-    min_message_buffer_length: typing.Optional[int] = pydantic.Field(default=None)
-    """
-    The desired minimum length of messages in the context window of the convo agent. This is a best effort, and may be off-by-one due to user/assistant interleaving.
-    """
-
-    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

letta_client/types/voice_sleeptime_manager_update.py

@@ -1,33 +0,0 @@
-# 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
-
-
-class VoiceSleeptimeManagerUpdate(UncheckedBaseModel):
-    manager_type: typing.Literal["voice_sleeptime"] = "voice_sleeptime"
-    manager_agent_id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    
-    """
-
-    max_message_buffer_length: typing.Optional[int] = pydantic.Field(default=None)
-    """
-    The desired maximum length of messages in the context window of the convo agent. This is a best effort, and may be off slightly due to user/assistant interleaving.
-    """
-
-    min_message_buffer_length: typing.Optional[int] = pydantic.Field(default=None)
-    """
-    The desired minimum length of messages in the context window of the convo agent. This is a best effort, and may be off-by-one due to user/assistant interleaving.
-    """
-
-    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

letta_client/types/web_search_options.py

@@ -1,22 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-from ..core.unchecked_base_model import UncheckedBaseModel
-import typing
-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):
-    search_context_size: typing.Optional[WebSearchOptionsSearchContextSize] = None
-    user_location: typing.Optional[WebSearchOptionsUserLocation] = 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

letta_client/types/web_search_options_search_context_size.py

@@ -1,5 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-
-WebSearchOptionsSearchContextSize = typing.Union[typing.Literal["low", "medium", "high"], typing.Any]

letta_client/types/web_search_options_user_location.py

@@ -1,21 +0,0 @@
-# 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
-
-
-class WebSearchOptionsUserLocation(UncheckedBaseModel):
-    approximate: WebSearchOptionsUserLocationApproximate
-    type: typing.Literal["approximate"] = "approximate"
-
-    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

letta_client/types/web_search_options_user_location_approximate.py

@@ -1,22 +0,0 @@
-# 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
-
-
-class WebSearchOptionsUserLocationApproximate(UncheckedBaseModel):
-    city: typing.Optional[str] = None
-    country: typing.Optional[str] = None
-    region: typing.Optional[str] = None
-    timezone: typing.Optional[str] = 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

letta_client/version.py

@@ -1,3 +0,0 @@
-from importlib import metadata
-
-__version__ = metadata.version("letta-client")

letta_client/voice/__init__.py

@@ -1,2 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-

letta_client/voice/client.py

@@ -1,177 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-from ..core.client_wrapper import 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
-
-# this is used as the default value for optional parameters
-OMIT = typing.cast(typing.Any, ...)
-
-
-class VoiceClient:
-    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,
-    ) -> 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
-        -------
-        typing.Optional[typing.Any]
-            Successful response
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-        client.voice.create_voice_chat_completions(
-            agent_id="agent_id",
-            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,
-        )
-        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)
-
-
-class AsyncVoiceClient:
-    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,
-    ) -> 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
-        -------
-        typing.Optional[typing.Any]
-            Successful response
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            project="YOUR_PROJECT",
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.voice.create_voice_chat_completions(
-                agent_id="agent_id",
-                request={"key": "value"},
-            )
-
-
-        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,
-        )
-        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)

letta_client-0.1.226.dist-info/METADATA

@@ -1,190 +0,0 @@
-Metadata-Version: 2.1
-Name: letta-client
-Version: 0.1.226
-Summary: 
-Requires-Python: >=3.8,<4.0
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: OS Independent
-Classifier: Operating System :: POSIX
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-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: typing_extensions (>=4.0.0)
-Description-Content-Type: text/markdown
-
-# Letta Python Library
-
-[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fletta-ai%2Fletta-python)
-[![pypi](https://img.shields.io/pypi/v/letta-client)](https://pypi.python.org/pypi/letta-client)
-
-The Letta Python library provides convenient access to the Letta API from Python.
-
-## Installation
-
-```sh
-pip install letta-client
-```
-
-## Reference
-
-A full reference for this library is available [here](https://github.com/letta-ai/letta-python/blob/HEAD/./reference.md).
-
-## Usage
-
-Instantiate and use the client with the following:
-
-```python
-from letta_client import Letta
-
-client = Letta(
-    project="YOUR_PROJECT",
-    token="YOUR_TOKEN",
-)
-client.tools.create(
-    source_code="source_code",
-)
-```
-
-## Async Client
-
-The SDK also exports an `async` client so that you can make non-blocking calls to our API.
-
-```python
-import asyncio
-
-from letta_client import AsyncLetta
-
-client = AsyncLetta(
-    project="YOUR_PROJECT",
-    token="YOUR_TOKEN",
-)
-
-
-async def main() -> None:
-    await client.tools.create(
-        source_code="source_code",
-    )
-
-
-asyncio.run(main())
-```
-
-## Exception Handling
-
-When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
-will be thrown.
-
-```python
-from letta_client.core.api_error import ApiError
-
-try:
-    client.tools.create(...)
-except ApiError as e:
-    print(e.status_code)
-    print(e.body)
-```
-
-## Streaming
-
-The SDK supports streaming responses, as well, the response will be a generator that you can loop over.
-
-```python
-from letta_client import Letta, StdioServerConfig
-
-client = Letta(
-    project="YOUR_PROJECT",
-    token="YOUR_TOKEN",
-)
-response = client.tools.connect_mcp_server(
-    request=StdioServerConfig(
-        server_name="server_name",
-        command="command",
-        args=["args"],
-    ),
-)
-for chunk in response:
-    yield chunk
-```
-
-## Advanced
-
-### Retries
-
-The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long
-as the request is deemed retryable and the number of retry attempts has not grown larger than the configured
-retry limit (default: 2).
-
-A request is deemed retryable when any of the following HTTP status codes is returned:
-
-- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)
-- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)
-- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)
-
-Use the `max_retries` request option to configure this behavior.
-
-```python
-client.tools.create(..., request_options={
-    "max_retries": 1
-})
-```
-
-### Timeouts
-
-The SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.
-
-```python
-
-from letta_client import Letta
-
-client = Letta(
-    ...,
-    timeout=20.0,
-)
-
-
-# Override timeout for a specific method
-client.tools.create(..., request_options={
-    "timeout_in_seconds": 1
-})
-```
-
-### Custom Client
-
-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
-
-client = Letta(
-    ...,
-    httpx_client=httpx.Client(
-        proxies="http://my.test.proxy.example.com",
-        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
-    ),
-)
-```
-
-## Contributing
-
-While we value open-source contributions to this SDK, this library is generated programmatically.
-Additions made directly to this library would have to be moved over to our generation code,
-otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
-a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
-an issue first to discuss with us!
-
-On the other hand, contributions to the README are always very welcome!
-