letta-client 0.1.295__py3-none-any.whl → 0.1.299__py3-none-any.whl

letta_client/__init__.py

@@ -16,6 +16,9 @@ from .types import (
     AppAuthScheme,
     AppAuthSchemeAuthMode,
     AppModel,
+    ApprovalCreate,
+    ApprovalRequestMessage,
+    ApprovalResponseMessage,
     AssistantMessage,
     AssistantMessageContent,
     Audio,
@@ -156,12 +159,14 @@ from .types import (
     JsonSchemaResponseFormat,
     LettaBatchMessages,
     LettaBatchRequest,
+    LettaBatchRequestMessagesItem,
     LettaImage,
     LettaMessageContentUnion,
     LettaMessageUnion,
     LettaPing,
     LettaRequest,
     LettaRequestConfig,
+    LettaRequestMessagesItem,
     LettaResponse,
     LettaSchemasAgentFileAgentSchema,
     LettaSchemasAgentFileAgentSchemaResponseFormat,
@@ -175,6 +180,7 @@ from .types import (
     LettaSerializeSchemasPydanticAgentSchemaToolSchema,
     LettaStopReason,
     LettaStreamingRequest,
+    LettaStreamingRequestMessagesItem,
     LettaUsageStatistics,
     LettaUserMessageContentUnion,
     LlmConfig,
@@ -443,6 +449,9 @@ __all__ = [
     "AppAuthScheme",
     "AppAuthSchemeAuthMode",
     "AppModel",
+    "ApprovalCreate",
+    "ApprovalRequestMessage",
+    "ApprovalResponseMessage",
     "AssistantMessage",
     "AssistantMessageContent",
     "AsyncLetta",
@@ -605,6 +614,7 @@ __all__ = [
     "Letta",
     "LettaBatchMessages",
     "LettaBatchRequest",
+    "LettaBatchRequestMessagesItem",
     "LettaEnvironment",
     "LettaImage",
     "LettaMessageContentUnion",
@@ -612,6 +622,7 @@ __all__ = [
     "LettaPing",
     "LettaRequest",
     "LettaRequestConfig",
+    "LettaRequestMessagesItem",
     "LettaResponse",
     "LettaSchemasAgentFileAgentSchema",
     "LettaSchemasAgentFileAgentSchemaResponseFormat",
@@ -625,6 +636,7 @@ __all__ = [
     "LettaSerializeSchemasPydanticAgentSchemaToolSchema",
     "LettaStopReason",
     "LettaStreamingRequest",
+    "LettaStreamingRequestMessagesItem",
     "LettaStreamingResponse",
     "LettaUsageStatistics",
     "LettaUserMessageContentUnion",

letta_client/agents/__init__.py

@@ -33,6 +33,7 @@ from . import (
 )
 from .memory_variables import MemoryVariablesListResponse
 from .messages import (
+    LettaAsyncRequestMessagesItem,
     LettaStreamingResponse,
     MessagesModifyRequest,
     MessagesModifyResponse,
@@ -52,6 +53,7 @@ __all__ = [
     "AgentsSearchResponse",
     "CreateAgentRequestResponseFormat",
     "CreateAgentRequestToolRulesItem",
+    "LettaAsyncRequestMessagesItem",
     "LettaStreamingResponse",
     "MemoryVariablesListResponse",
     "MessagesModifyRequest",

letta_client/agents/client.py

@@ -844,6 +844,52 @@ class AgentsClient:
         )
         return _response.data
 
+    def modify_approval(
+        self,
+        agent_id: str,
+        tool_name: str,
+        *,
+        requires_approval: bool,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentState:
+        """
+        Attach a tool to an agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        tool_name : str
+
+        requires_approval : bool
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+        client.agents.modify_approval(
+            agent_id="agent_id",
+            tool_name="tool_name",
+            requires_approval=True,
+        )
+        """
+        _response = self._raw_client.modify_approval(
+            agent_id, tool_name, requires_approval=requires_approval, request_options=request_options
+        )
+        return _response.data
+
     def list_agent_files(
         self,
         agent_id: str,
@@ -1868,6 +1914,60 @@ class AsyncAgentsClient:
         )
         return _response.data
 
+    async def modify_approval(
+        self,
+        agent_id: str,
+        tool_name: str,
+        *,
+        requires_approval: bool,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentState:
+        """
+        Attach a tool to an agent.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        tool_name : str
+
+        requires_approval : bool
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AgentState
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.modify_approval(
+                agent_id="agent_id",
+                tool_name="tool_name",
+                requires_approval=True,
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.modify_approval(
+            agent_id, tool_name, requires_approval=requires_approval, request_options=request_options
+        )
+        return _response.data
+
     async def list_agent_files(
         self,
         agent_id: str,

letta_client/agents/messages/__init__.py

@@ -3,6 +3,7 @@
 # isort: skip_file
 
 from .types import (
+    LettaAsyncRequestMessagesItem,
     LettaStreamingResponse,
     MessagesModifyRequest,
     MessagesModifyResponse,
@@ -10,6 +11,7 @@ from .types import (
 )
 
 __all__ = [
+    "LettaAsyncRequestMessagesItem",
     "LettaStreamingResponse",
     "MessagesModifyRequest",
     "MessagesModifyResponse",

letta_client/agents/messages/client.py

@@ -6,11 +6,13 @@ from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.agent_state import AgentState
 from ...types.letta_message_union import LettaMessageUnion
+from ...types.letta_request_messages_item import LettaRequestMessagesItem
 from ...types.letta_response import LettaResponse
-from ...types.message_create import MessageCreate
+from ...types.letta_streaming_request_messages_item import LettaStreamingRequestMessagesItem
 from ...types.message_type import MessageType
 from ...types.run import Run
 from .raw_client import AsyncRawMessagesClient, RawMessagesClient
+from .types.letta_async_request_messages_item import LettaAsyncRequestMessagesItem
 from .types.letta_streaming_response import LettaStreamingResponse
 from .types.messages_modify_request import MessagesModifyRequest
 from .types.messages_modify_response import MessagesModifyResponse
@@ -118,7 +120,7 @@ class MessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -135,7 +137,7 @@ class MessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -249,7 +251,7 @@ class MessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaStreamingRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -270,7 +272,7 @@ class MessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaStreamingRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -292,7 +294,7 @@ class MessagesClient:
             If set to True, enables reasoning before responses or tool calls from the agent.
 
         stream_tokens : typing.Optional[bool]
-            Flag to determine if individual tokens should be streamed. Set to True for token streaming (requires stream_steps = True).
+            Flag to determine if individual tokens should be streamed, rather than streaming per step.
 
         include_pings : typing.Optional[bool]
             Whether to include periodic keepalive ping messages in the stream to prevent connection timeouts.
@@ -394,7 +396,7 @@ class MessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaAsyncRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -415,7 +417,7 @@ class MessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaAsyncRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -687,7 +689,7 @@ class AsyncMessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -704,7 +706,7 @@ class AsyncMessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -836,7 +838,7 @@ class AsyncMessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaStreamingRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -857,7 +859,7 @@ class AsyncMessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaStreamingRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -879,7 +881,7 @@ class AsyncMessagesClient:
             If set to True, enables reasoning before responses or tool calls from the agent.
 
         stream_tokens : typing.Optional[bool]
-            Flag to determine if individual tokens should be streamed. Set to True for token streaming (requires stream_steps = True).
+            Flag to determine if individual tokens should be streamed, rather than streaming per step.
 
         include_pings : typing.Optional[bool]
             Whether to include periodic keepalive ping messages in the stream to prevent connection timeouts.
@@ -998,7 +1000,7 @@ class AsyncMessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaAsyncRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -1019,7 +1021,7 @@ class AsyncMessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaAsyncRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]

letta_client/agents/messages/raw_client.py

@@ -17,10 +17,12 @@ from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.agent_state import AgentState
 from ...types.http_validation_error import HttpValidationError
 from ...types.letta_message_union import LettaMessageUnion
+from ...types.letta_request_messages_item import LettaRequestMessagesItem
 from ...types.letta_response import LettaResponse
-from ...types.message_create import MessageCreate
+from ...types.letta_streaming_request_messages_item import LettaStreamingRequestMessagesItem
 from ...types.message_type import MessageType
 from ...types.run import Run
+from .types.letta_async_request_messages_item import LettaAsyncRequestMessagesItem
 from .types.letta_streaming_response import LettaStreamingResponse
 from .types.messages_modify_request import MessagesModifyRequest
 from .types.messages_modify_response import MessagesModifyResponse
@@ -132,7 +134,7 @@ class RawMessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -149,7 +151,7 @@ class RawMessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -183,7 +185,7 @@ class RawMessagesClient:
             method="POST",
             json={
                 "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
+                    object_=messages, annotation=typing.Sequence[LettaRequestMessagesItem], direction="write"
                 ),
                 "max_steps": max_steps,
                 "use_assistant_message": use_assistant_message,
@@ -294,7 +296,7 @@ class RawMessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaStreamingRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -315,7 +317,7 @@ class RawMessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaStreamingRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -337,7 +339,7 @@ class RawMessagesClient:
             If set to True, enables reasoning before responses or tool calls from the agent.
 
         stream_tokens : typing.Optional[bool]
-            Flag to determine if individual tokens should be streamed. Set to True for token streaming (requires stream_steps = True).
+            Flag to determine if individual tokens should be streamed, rather than streaming per step.
 
         include_pings : typing.Optional[bool]
             Whether to include periodic keepalive ping messages in the stream to prevent connection timeouts.
@@ -358,7 +360,7 @@ class RawMessagesClient:
             method="POST",
             json={
                 "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
+                    object_=messages, annotation=typing.Sequence[LettaStreamingRequestMessagesItem], direction="write"
                 ),
                 "max_steps": max_steps,
                 "use_assistant_message": use_assistant_message,
@@ -489,7 +491,7 @@ class RawMessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaAsyncRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -510,7 +512,7 @@ class RawMessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaAsyncRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -547,7 +549,7 @@ class RawMessagesClient:
             method="POST",
             json={
                 "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
+                    object_=messages, annotation=typing.Sequence[LettaAsyncRequestMessagesItem], direction="write"
                 ),
                 "max_steps": max_steps,
                 "use_assistant_message": use_assistant_message,
@@ -817,7 +819,7 @@ class AsyncRawMessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -834,7 +836,7 @@ class AsyncRawMessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -868,7 +870,7 @@ class AsyncRawMessagesClient:
             method="POST",
             json={
                 "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
+                    object_=messages, annotation=typing.Sequence[LettaRequestMessagesItem], direction="write"
                 ),
                 "max_steps": max_steps,
                 "use_assistant_message": use_assistant_message,
@@ -979,7 +981,7 @@ class AsyncRawMessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaStreamingRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -1000,7 +1002,7 @@ class AsyncRawMessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaStreamingRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -1022,7 +1024,7 @@ class AsyncRawMessagesClient:
             If set to True, enables reasoning before responses or tool calls from the agent.
 
         stream_tokens : typing.Optional[bool]
-            Flag to determine if individual tokens should be streamed. Set to True for token streaming (requires stream_steps = True).
+            Flag to determine if individual tokens should be streamed, rather than streaming per step.
 
         include_pings : typing.Optional[bool]
             Whether to include periodic keepalive ping messages in the stream to prevent connection timeouts.
@@ -1043,7 +1045,7 @@ class AsyncRawMessagesClient:
             method="POST",
             json={
                 "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
+                    object_=messages, annotation=typing.Sequence[LettaStreamingRequestMessagesItem], direction="write"
                 ),
                 "max_steps": max_steps,
                 "use_assistant_message": use_assistant_message,
@@ -1174,7 +1176,7 @@ class AsyncRawMessagesClient:
         self,
         agent_id: str,
         *,
-        messages: typing.Sequence[MessageCreate],
+        messages: typing.Sequence[LettaAsyncRequestMessagesItem],
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -1195,7 +1197,7 @@ class AsyncRawMessagesClient:
         ----------
         agent_id : str
 
-        messages : typing.Sequence[MessageCreate]
+        messages : typing.Sequence[LettaAsyncRequestMessagesItem]
             The messages to be sent to the agent.
 
         max_steps : typing.Optional[int]
@@ -1232,7 +1234,7 @@ class AsyncRawMessagesClient:
             method="POST",
             json={
                 "messages": convert_and_respect_annotation_metadata(
-                    object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
+                    object_=messages, annotation=typing.Sequence[LettaAsyncRequestMessagesItem], direction="write"
                 ),
                 "max_steps": max_steps,
                 "use_assistant_message": use_assistant_message,

letta_client/agents/messages/types/__init__.py

@@ -2,12 +2,14 @@
 
 # isort: skip_file
 
+from .letta_async_request_messages_item import LettaAsyncRequestMessagesItem
 from .letta_streaming_response import LettaStreamingResponse
 from .messages_modify_request import MessagesModifyRequest
 from .messages_modify_response import MessagesModifyResponse
 from .messages_preview_raw_payload_request import MessagesPreviewRawPayloadRequest
 
 __all__ = [
+    "LettaAsyncRequestMessagesItem",
     "LettaStreamingResponse",
     "MessagesModifyRequest",
     "MessagesModifyResponse",

letta_client/agents/messages/types/letta_async_request_messages_item.py

@@ -0,0 +1,8 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ....types.approval_create import ApprovalCreate
+from ....types.message_create import MessageCreate
+
+LettaAsyncRequestMessagesItem = typing.Union[MessageCreate, ApprovalCreate]

letta_client/agents/messages/types/messages_modify_response.py

@@ -2,6 +2,8 @@
 
 import typing
 
+from ....types.approval_request_message import ApprovalRequestMessage
+from ....types.approval_response_message import ApprovalResponseMessage
 from ....types.assistant_message import AssistantMessage
 from ....types.hidden_reasoning_message import HiddenReasoningMessage
 from ....types.reasoning_message import ReasoningMessage
@@ -18,4 +20,6 @@ MessagesModifyResponse = typing.Union[
     ToolCallMessage,
     ToolReturnMessage,
     AssistantMessage,
+    ApprovalRequestMessage,
+    ApprovalResponseMessage,
 ]