letta-client 0.1.123__py3-none-any.whl → 0.1.125__py3-none-any.whl

letta_client/providers/client.py

@@ -155,8 +155,8 @@ class ProvidersClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def delete_provider(
-        self, *, provider_id: str, request_options: typing.Optional[RequestOptions] = None
+    def delete(
+        self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.Optional[typing.Any]:
         """
         Delete an existing custom provider
@@ -164,7 +164,6 @@ class ProvidersClient:
         Parameters
         ----------
         provider_id : str
-            The provider_id key to be deleted.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -181,16 +180,13 @@ class ProvidersClient:
         client = Letta(
             token="YOUR_TOKEN",
         )
-        client.providers.delete_provider(
+        client.providers.delete(
             provider_id="provider_id",
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            "v1/providers/",
+            f"v1/providers/{jsonable_encoder(provider_id)}",
             method="DELETE",
-            params={
-                "provider_id": provider_id,
-            },
             request_options=request_options,
         )
         try:
@@ -217,16 +213,15 @@ class ProvidersClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def modify_provider(
-        self, *, id: str, api_key: str, request_options: typing.Optional[RequestOptions] = None
+    def modify(
+        self, provider_id: str, *, api_key: str, request_options: typing.Optional[RequestOptions] = None
     ) -> Provider:
         """
         Update an existing custom provider
 
         Parameters
         ----------
-        id : str
-            The id of the provider to update.
+        provider_id : str
 
         api_key : str
             API key used for requests to the provider.
@@ -246,16 +241,15 @@ class ProvidersClient:
         client = Letta(
             token="YOUR_TOKEN",
         )
-        client.providers.modify_provider(
-            id="id",
+        client.providers.modify(
+            provider_id="provider_id",
             api_key="api_key",
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            "v1/providers/",
+            f"v1/providers/{jsonable_encoder(provider_id)}",
             method="PATCH",
             json={
-                "id": id,
                 "api_key": api_key,
             },
             headers={
@@ -288,80 +282,6 @@ class ProvidersClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def delete(self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        provider_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            token="YOUR_TOKEN",
-        )
-        client.providers.delete(
-            provider_id="provider_id",
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/providers/{jsonable_encoder(provider_id)}",
-            method="DELETE",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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 modify(self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        provider_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            token="YOUR_TOKEN",
-        )
-        client.providers.modify(
-            provider_id="provider_id",
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/providers/{jsonable_encoder(provider_id)}",
-            method="PATCH",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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 AsyncProvidersClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -520,8 +440,8 @@ class AsyncProvidersClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def delete_provider(
-        self, *, provider_id: str, request_options: typing.Optional[RequestOptions] = None
+    async def delete(
+        self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.Optional[typing.Any]:
         """
         Delete an existing custom provider
@@ -529,7 +449,6 @@ class AsyncProvidersClient:
         Parameters
         ----------
         provider_id : str
-            The provider_id key to be deleted.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -551,7 +470,7 @@ class AsyncProvidersClient:
 
 
         async def main() -> None:
-            await client.providers.delete_provider(
+            await client.providers.delete(
                 provider_id="provider_id",
             )
 
@@ -559,11 +478,8 @@ class AsyncProvidersClient:
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            "v1/providers/",
+            f"v1/providers/{jsonable_encoder(provider_id)}",
             method="DELETE",
-            params={
-                "provider_id": provider_id,
-            },
             request_options=request_options,
         )
         try:
@@ -590,16 +506,15 @@ class AsyncProvidersClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def modify_provider(
-        self, *, id: str, api_key: str, request_options: typing.Optional[RequestOptions] = None
+    async def modify(
+        self, provider_id: str, *, api_key: str, request_options: typing.Optional[RequestOptions] = None
     ) -> Provider:
         """
         Update an existing custom provider
 
         Parameters
         ----------
-        id : str
-            The id of the provider to update.
+        provider_id : str
 
         api_key : str
             API key used for requests to the provider.
@@ -624,8 +539,8 @@ class AsyncProvidersClient:
 
 
         async def main() -> None:
-            await client.providers.modify_provider(
-                id="id",
+            await client.providers.modify(
+                provider_id="provider_id",
                 api_key="api_key",
             )
 
@@ -633,10 +548,9 @@ class AsyncProvidersClient:
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            "v1/providers/",
+            f"v1/providers/{jsonable_encoder(provider_id)}",
             method="PATCH",
             json={
-                "id": id,
                 "api_key": api_key,
             },
             headers={
@@ -668,93 +582,3 @@ class AsyncProvidersClient:
         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(self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        provider_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.providers.delete(
-                provider_id="provider_id",
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/providers/{jsonable_encoder(provider_id)}",
-            method="DELETE",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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 modify(self, provider_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        provider_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.providers.modify(
-                provider_id="provider_id",
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/providers/{jsonable_encoder(provider_id)}",
-            method="PATCH",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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/runs/client.py

@@ -26,7 +26,7 @@ class RunsClient:
         self.usage = UsageClient(client_wrapper=self._client_wrapper)
         self.steps = StepsClient(client_wrapper=self._client_wrapper)
 
-    def list_runs(
+    def list(
         self,
         *,
         agent_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
@@ -55,7 +55,7 @@ class RunsClient:
         client = Letta(
             token="YOUR_TOKEN",
         )
-        client.runs.list_runs()
+        client.runs.list()
         """
         _response = self._client_wrapper.httpx_client.request(
             "v1/runs/",
@@ -264,39 +264,6 @@ class RunsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            token="YOUR_TOKEN",
-        )
-        client.runs.list()
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            "v1/runs",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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 AsyncRunsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -305,7 +272,7 @@ class AsyncRunsClient:
         self.usage = AsyncUsageClient(client_wrapper=self._client_wrapper)
         self.steps = AsyncStepsClient(client_wrapper=self._client_wrapper)
 
-    async def list_runs(
+    async def list(
         self,
         *,
         agent_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
@@ -339,7 +306,7 @@ class AsyncRunsClient:
 
 
         async def main() -> None:
-            await client.runs.list_runs()
+            await client.runs.list()
 
 
         asyncio.run(main())
@@ -574,44 +541,3 @@ class AsyncRunsClient:
         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(self, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        import asyncio
-
-        from letta_client import AsyncLetta
-
-        client = AsyncLetta(
-            token="YOUR_TOKEN",
-        )
-
-
-        async def main() -> None:
-            await client.runs.list()
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            "v1/runs",
-            method="GET",
-            request_options=request_options,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _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/tags/client.py

@@ -3,6 +3,9 @@
 from ..core.client_wrapper import SyncClientWrapper
 import typing
 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
 from json.decoder import JSONDecodeError
 from ..core.api_error import ApiError
 from ..core.client_wrapper import AsyncClientWrapper
@@ -12,16 +15,32 @@ class TagsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
         self._client_wrapper = client_wrapper
 
-    def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+    def list(
+        self,
+        *,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        query_text: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[str]:
         """
+        Get a list of all tags in the database
+
         Parameters
         ----------
+        after : typing.Optional[str]
+
+        limit : typing.Optional[int]
+
+        query_text : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        None
+        typing.List[str]
+            Successful Response
 
         Examples
         --------
@@ -33,13 +52,34 @@ class TagsClient:
         client.tags.list()
         """
         _response = self._client_wrapper.httpx_client.request(
-            "v1/tags",
+            "v1/tags/",
             method="GET",
+            params={
+                "after": after,
+                "limit": limit,
+                "query_text": query_text,
+            },
             request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return
+                return typing.cast(
+                    typing.List[str],
+                    construct_type(
+                        type_=typing.List[str],  # 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)
@@ -50,16 +90,32 @@ class AsyncTagsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
         self._client_wrapper = client_wrapper
 
-    async def list(self, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+    async def list(
+        self,
+        *,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        query_text: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[str]:
         """
+        Get a list of all tags in the database
+
         Parameters
         ----------
+        after : typing.Optional[str]
+
+        limit : typing.Optional[int]
+
+        query_text : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        None
+        typing.List[str]
+            Successful Response
 
         Examples
         --------
@@ -79,13 +135,34 @@ class AsyncTagsClient:
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            "v1/tags",
+            "v1/tags/",
             method="GET",
+            params={
+                "after": after,
+                "limit": limit,
+                "query_text": query_text,
+            },
             request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return
+                return typing.cast(
+                    typing.List[str],
+                    construct_type(
+                        type_=typing.List[str],  # 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)

letta_client/types/__init__.py

@@ -7,6 +7,7 @@ from .agent_environment_variable import AgentEnvironmentVariable
 from .agent_schema import AgentSchema
 from .agent_schema_tool_rules_item import AgentSchemaToolRulesItem
 from .agent_state import AgentState
+from .agent_state_response_format import AgentStateResponseFormat
 from .agent_state_tool_rules_item import AgentStateToolRulesItem
 from .agent_type import AgentType
 from .app_auth_scheme import AppAuthScheme
@@ -113,7 +114,9 @@ from .internal_server_error_body import InternalServerErrorBody
 from .job import Job
 from .job_status import JobStatus
 from .job_type import JobType
+from .json_object_response_format import JsonObjectResponseFormat
 from .json_schema import JsonSchema
+from .json_schema_response_format import JsonSchemaResponseFormat
 from .letta_batch_request import LettaBatchRequest
 from .letta_message_content_union import LettaMessageContentUnion
 from .letta_message_union import LettaMessageUnion
@@ -189,6 +192,7 @@ from .system_message import SystemMessage
 from .tag_schema import TagSchema
 from .terminal_tool_rule import TerminalToolRule
 from .text_content import TextContent
+from .text_response_format import TextResponseFormat
 from .tool import Tool
 from .tool_call import ToolCall
 from .tool_call_content import ToolCallContent
@@ -232,6 +236,7 @@ __all__ = [
     "AgentSchema",
     "AgentSchemaToolRulesItem",
     "AgentState",
+    "AgentStateResponseFormat",
     "AgentStateToolRulesItem",
     "AgentType",
     "AppAuthScheme",
@@ -338,7 +343,9 @@ __all__ = [
     "Job",
     "JobStatus",
     "JobType",
+    "JsonObjectResponseFormat",
     "JsonSchema",
+    "JsonSchemaResponseFormat",
     "LettaBatchRequest",
     "LettaMessageContentUnion",
     "LettaMessageUnion",
@@ -410,6 +417,7 @@ __all__ = [
     "TagSchema",
     "TerminalToolRule",
     "TextContent",
+    "TextResponseFormat",
     "Tool",
     "ToolCall",
     "ToolCallContent",

letta_client/types/agent_state.py

@@ -8,6 +8,7 @@ from .agent_state_tool_rules_item import AgentStateToolRulesItem
 from .agent_type import AgentType
 from .llm_config import LlmConfig
 from .embedding_config import EmbeddingConfig
+from .agent_state_response_format import AgentStateResponseFormat
 from .memory import Memory
 from .tool import Tool
 from .source import Source
@@ -92,6 +93,11 @@ class AgentState(UncheckedBaseModel):
     The embedding configuration used by the agent.
     """
 
+    response_format: typing.Optional[AgentStateResponseFormat] = pydantic.Field(default=None)
+    """
+    The response format used by the agent when returning from `send_message`.
+    """
+
     description: typing.Optional[str] = pydantic.Field(default=None)
     """
     The description of the agent.

letta_client/types/agent_state_response_format.py

@@ -0,0 +1,8 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .json_object_response_format import JsonObjectResponseFormat
+from .json_schema_response_format import JsonSchemaResponseFormat
+from .text_response_format import TextResponseFormat
+
+AgentStateResponseFormat = typing.Union[JsonObjectResponseFormat, JsonSchemaResponseFormat, TextResponseFormat]