letta-client 0.1.123__tar.gz → 0.1.125__tar.gz

{letta_client-0.1.123 → letta_client-0.1.125}/PKG-INFO

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

{letta_client-0.1.123 → letta_client-0.1.125}/pyproject.toml

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

{letta_client-0.1.123 → letta_client-0.1.125}/src/letta_client/__init__.py

@@ -8,6 +8,7 @@ from .types import (
     AgentSchema,
     AgentSchemaToolRulesItem,
     AgentState,
+    AgentStateResponseFormat,
     AgentStateToolRulesItem,
     AgentType,
     AppAuthScheme,
@@ -114,7 +115,9 @@ from .types import (
     Job,
     JobStatus,
     JobType,
+    JsonObjectResponseFormat,
     JsonSchema,
+    JsonSchemaResponseFormat,
     LettaBatchRequest,
     LettaMessageContentUnion,
     LettaMessageUnion,
@@ -186,6 +189,7 @@ from .types import (
     TagSchema,
     TerminalToolRule,
     TextContent,
+    TextResponseFormat,
     Tool,
     ToolCall,
     ToolCallContent,
@@ -232,14 +236,12 @@ from . import (
     health,
     identities,
     jobs,
-    messages,
     models,
     projects,
     providers,
     runs,
     sources,
     steps,
-    tag,
     tags,
     templates,
     tools,
@@ -253,7 +255,9 @@ from .agents import (
     AgentsSearchRequestSearchItemTwo,
     AgentsSearchRequestSearchItemZero,
     AgentsSearchResponse,
+    CreateAgentRequestResponseFormat,
     CreateAgentRequestToolRulesItem,
+    UpdateAgentResponseFormat,
     UpdateAgentToolRulesItem,
 )
 from .client import AsyncLetta, Letta
@@ -288,6 +292,7 @@ __all__ = [
     "AgentSchema",
     "AgentSchemaToolRulesItem",
     "AgentState",
+    "AgentStateResponseFormat",
     "AgentStateToolRulesItem",
     "AgentType",
     "AgentsSearchRequestSearchItem",
@@ -377,6 +382,7 @@ __all__ = [
     "ContextWindowOverview",
     "ContinueToolRule",
     "CoreMemoryBlockSchema",
+    "CreateAgentRequestResponseFormat",
     "CreateAgentRequestToolRulesItem",
     "CreateBlock",
     "CreateVoiceChatCompletionsRequestBody",
@@ -416,7 +422,9 @@ __all__ = [
     "Job",
     "JobStatus",
     "JobType",
+    "JsonObjectResponseFormat",
     "JsonSchema",
+    "JsonSchemaResponseFormat",
     "Letta",
     "LettaBatchRequest",
     "LettaEnvironment",
@@ -496,6 +504,7 @@ __all__ = [
     "TemplatesListResponseTemplatesItem",
     "TerminalToolRule",
     "TextContent",
+    "TextResponseFormat",
     "Tool",
     "ToolCall",
     "ToolCallContent",
@@ -513,6 +522,7 @@ __all__ = [
     "ToolSchema",
     "ToolType",
     "UnprocessableEntityError",
+    "UpdateAgentResponseFormat",
     "UpdateAgentToolRulesItem",
     "UpdateAssistantMessage",
     "UpdateAssistantMessageContent",
@@ -542,14 +552,12 @@ __all__ = [
     "health",
     "identities",
     "jobs",
-    "messages",
     "models",
     "projects",
     "providers",
     "runs",
     "sources",
     "steps",
-    "tag",
     "tags",
     "templates",
     "tools",

{letta_client-0.1.123 → letta_client-0.1.125}/src/letta_client/agents/__init__.py

@@ -8,7 +8,9 @@ from .types import (
     AgentsSearchRequestSearchItemTwo,
     AgentsSearchRequestSearchItemZero,
     AgentsSearchResponse,
+    CreateAgentRequestResponseFormat,
     CreateAgentRequestToolRulesItem,
+    UpdateAgentResponseFormat,
     UpdateAgentToolRulesItem,
 )
 from . import blocks, context, core_memory, groups, memory_variables, messages, passages, sources, templates, tools
@@ -24,6 +26,7 @@ __all__ = [
     "AgentsSearchRequestSearchItemTwo",
     "AgentsSearchRequestSearchItemZero",
     "AgentsSearchResponse",
+    "CreateAgentRequestResponseFormat",
     "CreateAgentRequestToolRulesItem",
     "LettaStreamingResponse",
     "MemoryVariablesListResponse",
@@ -31,6 +34,7 @@ __all__ = [
     "MessagesModifyResponse",
     "TemplatesCreateResponse",
     "TemplatesMigrateResponse",
+    "UpdateAgentResponseFormat",
     "UpdateAgentToolRulesItem",
     "blocks",
     "context",

{letta_client-0.1.123 → letta_client-0.1.125}/src/letta_client/agents/client.py

@@ -25,10 +25,12 @@ from ..types.agent_type import AgentType
 from ..types.llm_config import LlmConfig
 from ..types.embedding_config import EmbeddingConfig
 from ..types.message_create import MessageCreate
+from .types.create_agent_request_response_format import CreateAgentRequestResponseFormat
 from ..core.serialization import convert_and_respect_annotation_metadata
 from ..core.jsonable_encoder import jsonable_encoder
 from .. import core
 from .types.update_agent_tool_rules_item import UpdateAgentToolRulesItem
+from .types.update_agent_response_format import UpdateAgentResponseFormat
 from .types.agents_search_request_search_item import AgentsSearchRequestSearchItem
 from .types.agents_search_response import AgentsSearchResponse
 from ..core.client_wrapper import AsyncClientWrapper
@@ -232,6 +234,7 @@ class AgentsClient:
         identity_ids: typing.Optional[typing.Sequence[str]] = OMIT,
         message_buffer_autoclear: typing.Optional[bool] = OMIT,
         enable_sleeptime: typing.Optional[bool] = OMIT,
+        response_format: typing.Optional[CreateAgentRequestResponseFormat] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -349,6 +352,9 @@ class AgentsClient:
         enable_sleeptime : typing.Optional[bool]
             If set to True, memory management will move to a background agent thread.
 
+        response_format : typing.Optional[CreateAgentRequestResponseFormat]
+            The response format for the agent.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -416,6 +422,9 @@ class AgentsClient:
                 "identity_ids": identity_ids,
                 "message_buffer_autoclear": message_buffer_autoclear,
                 "enable_sleeptime": enable_sleeptime,
+                "response_format": convert_and_respect_annotation_metadata(
+                    object_=response_format, annotation=CreateAgentRequestResponseFormat, direction="write"
+                ),
             },
             headers={
                 "content-type": "application/json",
@@ -448,7 +457,7 @@ class AgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def export_agent_serialized(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> str:
+    def export(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> str:
         """
         Export the serialized JSON representation of an agent, formatted with indentation.
 
@@ -471,7 +480,7 @@ class AgentsClient:
         client = Letta(
             token="YOUR_TOKEN",
         )
-        client.agents.export_agent_serialized(
+        client.agents.export(
             agent_id="agent_id",
         )
         """
@@ -504,43 +513,6 @@ class AgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def export(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        agent_id : str
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        from letta_client import Letta
-
-        client = Letta(
-            token="YOUR_TOKEN",
-        )
-        client.agents.export(
-            agent_id="agent_id",
-        )
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/export",
-            method="POST",
-            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 import_(
         self,
         *,
@@ -767,6 +739,7 @@ class AgentsClient:
         model: typing.Optional[str] = OMIT,
         embedding: typing.Optional[str] = OMIT,
         enable_sleeptime: typing.Optional[bool] = OMIT,
+        response_format: typing.Optional[UpdateAgentResponseFormat] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -839,6 +812,9 @@ class AgentsClient:
         enable_sleeptime : typing.Optional[bool]
             If set to True, memory management will move to a background agent thread.
 
+        response_format : typing.Optional[UpdateAgentResponseFormat]
+            The response format for the agent.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -889,6 +865,9 @@ class AgentsClient:
                 "model": model,
                 "embedding": embedding,
                 "enable_sleeptime": enable_sleeptime,
+                "response_format": convert_and_respect_annotation_metadata(
+                    object_=response_format, annotation=UpdateAgentResponseFormat, direction="write"
+                ),
             },
             headers={
                 "content-type": "application/json",
@@ -1190,6 +1169,7 @@ class AsyncAgentsClient:
         identity_ids: typing.Optional[typing.Sequence[str]] = OMIT,
         message_buffer_autoclear: typing.Optional[bool] = OMIT,
         enable_sleeptime: typing.Optional[bool] = OMIT,
+        response_format: typing.Optional[CreateAgentRequestResponseFormat] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -1307,6 +1287,9 @@ class AsyncAgentsClient:
         enable_sleeptime : typing.Optional[bool]
             If set to True, memory management will move to a background agent thread.
 
+        response_format : typing.Optional[CreateAgentRequestResponseFormat]
+            The response format for the agent.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1382,6 +1365,9 @@ class AsyncAgentsClient:
                 "identity_ids": identity_ids,
                 "message_buffer_autoclear": message_buffer_autoclear,
                 "enable_sleeptime": enable_sleeptime,
+                "response_format": convert_and_respect_annotation_metadata(
+                    object_=response_format, annotation=CreateAgentRequestResponseFormat, direction="write"
+                ),
             },
             headers={
                 "content-type": "application/json",
@@ -1414,9 +1400,7 @@ class AsyncAgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def export_agent_serialized(
-        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
-    ) -> str:
+    async def export(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> str:
         """
         Export the serialized JSON representation of an agent, formatted with indentation.
 
@@ -1444,7 +1428,7 @@ class AsyncAgentsClient:
 
 
         async def main() -> None:
-            await client.agents.export_agent_serialized(
+            await client.agents.export(
                 agent_id="agent_id",
             )
 
@@ -1480,51 +1464,6 @@ class AsyncAgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def export(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
-        """
-        Parameters
-        ----------
-        agent_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.agents.export(
-                agent_id="agent_id",
-            )
-
-
-        asyncio.run(main())
-        """
-        _response = await self._client_wrapper.httpx_client.request(
-            f"v1/agents/{jsonable_encoder(agent_id)}/export",
-            method="POST",
-            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 import_(
         self,
         *,
@@ -1775,6 +1714,7 @@ class AsyncAgentsClient:
         model: typing.Optional[str] = OMIT,
         embedding: typing.Optional[str] = OMIT,
         enable_sleeptime: typing.Optional[bool] = OMIT,
+        response_format: typing.Optional[UpdateAgentResponseFormat] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -1847,6 +1787,9 @@ class AsyncAgentsClient:
         enable_sleeptime : typing.Optional[bool]
             If set to True, memory management will move to a background agent thread.
 
+        response_format : typing.Optional[UpdateAgentResponseFormat]
+            The response format for the agent.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1905,6 +1848,9 @@ class AsyncAgentsClient:
                 "model": model,
                 "embedding": embedding,
                 "enable_sleeptime": enable_sleeptime,
+                "response_format": convert_and_respect_annotation_metadata(
+                    object_=response_format, annotation=UpdateAgentResponseFormat, direction="write"
+                ),
             },
             headers={
                 "content-type": "application/json",

{letta_client-0.1.123 → letta_client-0.1.125}/src/letta_client/agents/types/__init__.py

@@ -7,7 +7,9 @@ from .agents_search_request_search_item_operator import AgentsSearchRequestSearc
 from .agents_search_request_search_item_two import AgentsSearchRequestSearchItemTwo
 from .agents_search_request_search_item_zero import AgentsSearchRequestSearchItemZero
 from .agents_search_response import AgentsSearchResponse
+from .create_agent_request_response_format import CreateAgentRequestResponseFormat
 from .create_agent_request_tool_rules_item import CreateAgentRequestToolRulesItem
+from .update_agent_response_format import UpdateAgentResponseFormat
 from .update_agent_tool_rules_item import UpdateAgentToolRulesItem
 
 __all__ = [
@@ -18,6 +20,8 @@ __all__ = [
     "AgentsSearchRequestSearchItemTwo",
     "AgentsSearchRequestSearchItemZero",
     "AgentsSearchResponse",
+    "CreateAgentRequestResponseFormat",
     "CreateAgentRequestToolRulesItem",
+    "UpdateAgentResponseFormat",
     "UpdateAgentToolRulesItem",
 ]

letta_client-0.1.125/src/letta_client/agents/types/create_agent_request_response_format.py

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

letta_client-0.1.125/src/letta_client/agents/types/update_agent_response_format.py

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

{letta_client-0.1.123 → letta_client-0.1.125}/src/letta_client/base_client.py

@@ -17,14 +17,12 @@ from .health.client import HealthClient
 from .providers.client import ProvidersClient
 from .runs.client import RunsClient
 from .steps.client import StepsClient
-from .tag.client import TagClient
+from .tags.client import TagsClient
 from .batches.client import BatchesClient
-from .messages.client import MessagesClient
 from .voice.client import VoiceClient
 from .templates.client import TemplatesClient
 from .client_side_access_tokens.client import ClientSideAccessTokensClient
 from .projects.client import ProjectsClient
-from .tags.client import TagsClient
 from .core.client_wrapper import AsyncClientWrapper
 from .tools.client import AsyncToolsClient
 from .sources.client import AsyncSourcesClient
@@ -39,14 +37,12 @@ from .health.client import AsyncHealthClient
 from .providers.client import AsyncProvidersClient
 from .runs.client import AsyncRunsClient
 from .steps.client import AsyncStepsClient
-from .tag.client import AsyncTagClient
+from .tags.client import AsyncTagsClient
 from .batches.client import AsyncBatchesClient
-from .messages.client import AsyncMessagesClient
 from .voice.client import AsyncVoiceClient
 from .templates.client import AsyncTemplatesClient
 from .client_side_access_tokens.client import AsyncClientSideAccessTokensClient
 from .projects.client import AsyncProjectsClient
-from .tags.client import AsyncTagsClient
 
 
 class LettaBase:
@@ -120,14 +116,12 @@ class LettaBase:
         self.providers = ProvidersClient(client_wrapper=self._client_wrapper)
         self.runs = RunsClient(client_wrapper=self._client_wrapper)
         self.steps = StepsClient(client_wrapper=self._client_wrapper)
-        self.tag = TagClient(client_wrapper=self._client_wrapper)
+        self.tags = TagsClient(client_wrapper=self._client_wrapper)
         self.batches = BatchesClient(client_wrapper=self._client_wrapper)
-        self.messages = MessagesClient(client_wrapper=self._client_wrapper)
         self.voice = VoiceClient(client_wrapper=self._client_wrapper)
         self.templates = TemplatesClient(client_wrapper=self._client_wrapper)
         self.client_side_access_tokens = ClientSideAccessTokensClient(client_wrapper=self._client_wrapper)
         self.projects = ProjectsClient(client_wrapper=self._client_wrapper)
-        self.tags = TagsClient(client_wrapper=self._client_wrapper)
 
 
 class AsyncLettaBase:
@@ -201,14 +195,12 @@ class AsyncLettaBase:
         self.providers = AsyncProvidersClient(client_wrapper=self._client_wrapper)
         self.runs = AsyncRunsClient(client_wrapper=self._client_wrapper)
         self.steps = AsyncStepsClient(client_wrapper=self._client_wrapper)
-        self.tag = AsyncTagClient(client_wrapper=self._client_wrapper)
+        self.tags = AsyncTagsClient(client_wrapper=self._client_wrapper)
         self.batches = AsyncBatchesClient(client_wrapper=self._client_wrapper)
-        self.messages = AsyncMessagesClient(client_wrapper=self._client_wrapper)
         self.voice = AsyncVoiceClient(client_wrapper=self._client_wrapper)
         self.templates = AsyncTemplatesClient(client_wrapper=self._client_wrapper)
         self.client_side_access_tokens = AsyncClientSideAccessTokensClient(client_wrapper=self._client_wrapper)
         self.projects = AsyncProjectsClient(client_wrapper=self._client_wrapper)
-        self.tags = AsyncTagsClient(client_wrapper=self._client_wrapper)
 
 
 def _get_base_url(*, base_url: typing.Optional[str] = None, environment: LettaEnvironment) -> str:

{letta_client-0.1.123 → letta_client-0.1.125}/src/letta_client/batches/client.py

@@ -221,8 +221,12 @@ class BatchesClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def cancel(self, batch_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+    def cancel(
+        self, batch_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.Optional[typing.Any]:
         """
+        Cancel a batch run.
+
         Parameters
         ----------
         batch_id : str
@@ -232,7 +236,8 @@ class BatchesClient:
 
         Returns
         -------
-        None
+        typing.Optional[typing.Any]
+            Successful Response
 
         Examples
         --------
@@ -246,13 +251,29 @@ class BatchesClient:
         )
         """
         _response = self._client_wrapper.httpx_client.request(
-            f"v1/messages/batches/{jsonable_encoder(batch_id)}",
+            f"v1/messages/batches/{jsonable_encoder(batch_id)}/cancel",
             method="PATCH",
             request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return
+                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)
@@ -491,8 +512,12 @@ class AsyncBatchesClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def cancel(self, batch_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+    async def cancel(
+        self, batch_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.Optional[typing.Any]:
         """
+        Cancel a batch run.
+
         Parameters
         ----------
         batch_id : str
@@ -502,7 +527,8 @@ class AsyncBatchesClient:
 
         Returns
         -------
-        None
+        typing.Optional[typing.Any]
+            Successful Response
 
         Examples
         --------
@@ -524,13 +550,29 @@ class AsyncBatchesClient:
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            f"v1/messages/batches/{jsonable_encoder(batch_id)}",
+            f"v1/messages/batches/{jsonable_encoder(batch_id)}/cancel",
             method="PATCH",
             request_options=request_options,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return
+                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)

{letta_client-0.1.123 → letta_client-0.1.125}/src/letta_client/core/client_wrapper.py

@@ -16,7 +16,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.123",
+            "X-Fern-SDK-Version": "0.1.125",
         }
         if self.token is not None:
             headers["Authorization"] = f"Bearer {self.token}"