letta-client 1.0.0a14__tar.gz → 1.0.0a15__tar.gz

letta_client-1.0.0a15/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.0.0-alpha.15"
+}

{letta_client-1.0.0a14 → letta_client-1.0.0a15}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.0.0-alpha.15 (2025-11-04)
+
+Full Changelog: [v1.0.0-alpha.14...v1.0.0-alpha.15](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.14...v1.0.0-alpha.15)
+
+### Features
+
+* add `EventMessage` and `SummaryMessage` ([543571c](https://github.com/letta-ai/letta-python/commit/543571ccdfd7f416c7ed4aca44007155019ed424))
+* add input option to send message route [LET-4540] ([566914d](https://github.com/letta-ai/letta-python/commit/566914db30baedd9354813fccc48dd17483a98e8))
+* make sure tool return chars within max int range ([4c90f6d](https://github.com/letta-ai/letta-python/commit/4c90f6dacfe214aede582881c264fbad5f5bc99c))
+
 ## 1.0.0-alpha.14 (2025-11-04)
 
 Full Changelog: [v1.0.0-alpha.13...v1.0.0-alpha.14](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.13...v1.0.0-alpha.14)

{letta_client-1.0.0a14 → letta_client-1.0.0a15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: letta-client
-Version: 1.0.0a14
+Version: 1.0.0a15
 Summary: The official Python library for the letta API
 Project-URL: Homepage, https://github.com/letta-ai/letta-python
 Project-URL: Repository, https://github.com/letta-ai/letta-python

{letta_client-1.0.0a14 → letta_client-1.0.0a15}/api.md

@@ -214,6 +214,7 @@ from letta_client.types.agents import (
     ApprovalRequestMessage,
     ApprovalResponseMessage,
     AssistantMessage,
+    EventMessage,
     HiddenReasoningMessage,
     ImageContent,
     JobStatus,
@@ -233,6 +234,7 @@ from letta_client.types.agents import (
     ReasoningMessage,
     RedactedReasoningContent,
     Run,
+    SummaryMessage,
     SystemMessage,
     TextContent,
     ToolCall,

{letta_client-1.0.0a14 → letta_client-1.0.0a15}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "letta-client"
-version = "1.0.0-alpha.14"
+version = "1.0.0-alpha.15"
 description = "The official Python library for the letta API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{letta_client-1.0.0a14 → letta_client-1.0.0a15}/src/letta_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "letta_client"
-__version__ = "1.0.0-alpha.14"  # x-release-please-version
+__version__ = "1.0.0-alpha.15"  # x-release-please-version

{letta_client-1.0.0a14 → letta_client-1.0.0a15}/src/letta_client/resources/agents/messages.py

@@ -425,12 +425,13 @@ class MessagesResource(SyncAPIResource):
         self,
         agent_id: str,
         *,
-        messages: Iterable[message_send_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_send_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_send_params.Message]] | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -447,8 +448,6 @@ class MessagesResource(SyncAPIResource):
         Args:
           agent_id: The ID of the agent in the format 'agent-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -460,8 +459,14 @@ class MessagesResource(SyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           use_assistant_message: Whether the server should parse specific tool call arguments (default
               `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
               types, but deprecated for letta_v1_agent onward.
@@ -480,12 +485,13 @@ class MessagesResource(SyncAPIResource):
             f"/v1/agents/{agent_id}/messages",
             body=maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "enable_thinking": enable_thinking,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "use_assistant_message": use_assistant_message,
                 },
                 message_send_params.MessageSendParams,
@@ -500,13 +506,14 @@ class MessagesResource(SyncAPIResource):
         self,
         agent_id: str,
         *,
-        messages: Iterable[message_send_async_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         callback_url: Optional[str] | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_send_async_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_send_async_params.Message]] | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -527,8 +534,6 @@ class MessagesResource(SyncAPIResource):
         Args:
           agent_id: The ID of the agent in the format 'agent-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -542,8 +547,14 @@ class MessagesResource(SyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           use_assistant_message: Whether the server should parse specific tool call arguments (default
               `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
               types, but deprecated for letta_v1_agent onward.
@@ -562,13 +573,14 @@ class MessagesResource(SyncAPIResource):
             f"/v1/agents/{agent_id}/messages/async",
             body=maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "callback_url": callback_url,
                     "enable_thinking": enable_thinking,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "use_assistant_message": use_assistant_message,
                 },
                 message_send_async_params.MessageSendAsyncParams,
@@ -583,14 +595,15 @@ class MessagesResource(SyncAPIResource):
         self,
         agent_id: str,
         *,
-        messages: Iterable[message_stream_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         background: bool | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_pings: bool | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_stream_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_stream_params.Message]] | Omit = omit,
         stream_tokens: bool | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -609,8 +622,6 @@ class MessagesResource(SyncAPIResource):
         Args:
           agent_id: The ID of the agent in the format 'agent-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -627,8 +638,14 @@ class MessagesResource(SyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           stream_tokens: Flag to determine if individual tokens should be streamed, rather than streaming
               per step.
 
@@ -650,14 +667,15 @@ class MessagesResource(SyncAPIResource):
             f"/v1/agents/{agent_id}/messages/stream",
             body=maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "background": background,
                     "enable_thinking": enable_thinking,
                     "include_pings": include_pings,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "stream_tokens": stream_tokens,
                     "use_assistant_message": use_assistant_message,
                 },
@@ -1092,12 +1110,13 @@ class AsyncMessagesResource(AsyncAPIResource):
         self,
         agent_id: str,
         *,
-        messages: Iterable[message_send_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_send_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_send_params.Message]] | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -1114,8 +1133,6 @@ class AsyncMessagesResource(AsyncAPIResource):
         Args:
           agent_id: The ID of the agent in the format 'agent-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -1127,8 +1144,14 @@ class AsyncMessagesResource(AsyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           use_assistant_message: Whether the server should parse specific tool call arguments (default
               `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
               types, but deprecated for letta_v1_agent onward.
@@ -1147,12 +1170,13 @@ class AsyncMessagesResource(AsyncAPIResource):
             f"/v1/agents/{agent_id}/messages",
             body=await async_maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "enable_thinking": enable_thinking,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "use_assistant_message": use_assistant_message,
                 },
                 message_send_params.MessageSendParams,
@@ -1167,13 +1191,14 @@ class AsyncMessagesResource(AsyncAPIResource):
         self,
         agent_id: str,
         *,
-        messages: Iterable[message_send_async_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         callback_url: Optional[str] | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_send_async_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_send_async_params.Message]] | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -1194,8 +1219,6 @@ class AsyncMessagesResource(AsyncAPIResource):
         Args:
           agent_id: The ID of the agent in the format 'agent-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -1209,8 +1232,14 @@ class AsyncMessagesResource(AsyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           use_assistant_message: Whether the server should parse specific tool call arguments (default
               `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
               types, but deprecated for letta_v1_agent onward.
@@ -1229,13 +1258,14 @@ class AsyncMessagesResource(AsyncAPIResource):
             f"/v1/agents/{agent_id}/messages/async",
             body=await async_maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "callback_url": callback_url,
                     "enable_thinking": enable_thinking,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "use_assistant_message": use_assistant_message,
                 },
                 message_send_async_params.MessageSendAsyncParams,
@@ -1250,14 +1280,15 @@ class AsyncMessagesResource(AsyncAPIResource):
         self,
         agent_id: str,
         *,
-        messages: Iterable[message_stream_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         background: bool | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_pings: bool | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_stream_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_stream_params.Message]] | Omit = omit,
         stream_tokens: bool | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -1276,8 +1307,6 @@ class AsyncMessagesResource(AsyncAPIResource):
         Args:
           agent_id: The ID of the agent in the format 'agent-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -1294,8 +1323,14 @@ class AsyncMessagesResource(AsyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           stream_tokens: Flag to determine if individual tokens should be streamed, rather than streaming
               per step.
 
@@ -1317,14 +1352,15 @@ class AsyncMessagesResource(AsyncAPIResource):
             f"/v1/agents/{agent_id}/messages/stream",
             body=await async_maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "background": background,
                     "enable_thinking": enable_thinking,
                     "include_pings": include_pings,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "stream_tokens": stream_tokens,
                     "use_assistant_message": use_assistant_message,
                 },

{letta_client-1.0.0a14 → letta_client-1.0.0a15}/src/letta_client/resources/groups/messages.py

@@ -356,12 +356,13 @@ class MessagesResource(SyncAPIResource):
         self,
         group_id: str,
         *,
-        messages: Iterable[message_send_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_send_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_send_params.Message]] | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -379,8 +380,6 @@ class MessagesResource(SyncAPIResource):
         Args:
           group_id: The ID of the group in the format 'group-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -392,8 +391,14 @@ class MessagesResource(SyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           use_assistant_message: Whether the server should parse specific tool call arguments (default
               `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
               types, but deprecated for letta_v1_agent onward.
@@ -412,12 +417,13 @@ class MessagesResource(SyncAPIResource):
             f"/v1/groups/{group_id}/messages",
             body=maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "enable_thinking": enable_thinking,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "use_assistant_message": use_assistant_message,
                 },
                 message_send_params.MessageSendParams,
@@ -432,14 +438,15 @@ class MessagesResource(SyncAPIResource):
         self,
         group_id: str,
         *,
-        messages: Iterable[message_stream_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         background: bool | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_pings: bool | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_stream_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_stream_params.Message]] | Omit = omit,
         stream_tokens: bool | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -459,8 +466,6 @@ class MessagesResource(SyncAPIResource):
         Args:
           group_id: The ID of the group in the format 'group-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -477,8 +482,14 @@ class MessagesResource(SyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           stream_tokens: Flag to determine if individual tokens should be streamed, rather than streaming
               per step.
 
@@ -500,14 +511,15 @@ class MessagesResource(SyncAPIResource):
             f"/v1/groups/{group_id}/messages/stream",
             body=maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "background": background,
                     "enable_thinking": enable_thinking,
                     "include_pings": include_pings,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "stream_tokens": stream_tokens,
                     "use_assistant_message": use_assistant_message,
                 },
@@ -846,12 +858,13 @@ class AsyncMessagesResource(AsyncAPIResource):
         self,
         group_id: str,
         *,
-        messages: Iterable[message_send_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_send_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_send_params.Message]] | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -869,8 +882,6 @@ class AsyncMessagesResource(AsyncAPIResource):
         Args:
           group_id: The ID of the group in the format 'group-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -882,8 +893,14 @@ class AsyncMessagesResource(AsyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           use_assistant_message: Whether the server should parse specific tool call arguments (default
               `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
               types, but deprecated for letta_v1_agent onward.
@@ -902,12 +919,13 @@ class AsyncMessagesResource(AsyncAPIResource):
             f"/v1/groups/{group_id}/messages",
             body=await async_maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "enable_thinking": enable_thinking,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "use_assistant_message": use_assistant_message,
                 },
                 message_send_params.MessageSendParams,
@@ -922,14 +940,15 @@ class AsyncMessagesResource(AsyncAPIResource):
         self,
         group_id: str,
         *,
-        messages: Iterable[message_stream_params.Message],
         assistant_message_tool_kwarg: str | Omit = omit,
         assistant_message_tool_name: str | Omit = omit,
         background: bool | Omit = omit,
         enable_thinking: str | Omit = omit,
         include_pings: bool | Omit = omit,
         include_return_message_types: Optional[List[MessageType]] | Omit = omit,
+        input: Union[str, Iterable[message_stream_params.InputUnionMember1], None] | Omit = omit,
         max_steps: int | Omit = omit,
+        messages: Optional[Iterable[message_stream_params.Message]] | Omit = omit,
         stream_tokens: bool | Omit = omit,
         use_assistant_message: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -949,8 +968,6 @@ class AsyncMessagesResource(AsyncAPIResource):
         Args:
           group_id: The ID of the group in the format 'group-<uuid4>'
 
-          messages: The messages to be sent to the agent.
-
           assistant_message_tool_kwarg: The name of the message argument in the designated message tool. Still supported
               for legacy agent types, but deprecated for letta_v1_agent onward.
 
@@ -967,8 +984,14 @@ class AsyncMessagesResource(AsyncAPIResource):
           include_return_message_types: Only return specified message types in the response. If `None` (default) returns
               all messages.
 
+          input:
+              Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+              'user', 'content': input}].
+
           max_steps: Maximum number of steps the agent should take to process the request.
 
+          messages: The messages to be sent to the agent.
+
           stream_tokens: Flag to determine if individual tokens should be streamed, rather than streaming
               per step.
 
@@ -990,14 +1013,15 @@ class AsyncMessagesResource(AsyncAPIResource):
             f"/v1/groups/{group_id}/messages/stream",
             body=await async_maybe_transform(
                 {
-                    "messages": messages,
                     "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
                     "assistant_message_tool_name": assistant_message_tool_name,
                     "background": background,
                     "enable_thinking": enable_thinking,
                     "include_pings": include_pings,
                     "include_return_message_types": include_return_message_types,
+                    "input": input,
                     "max_steps": max_steps,
+                    "messages": messages,
                     "stream_tokens": stream_tokens,
                     "use_assistant_message": use_assistant_message,
                 },

{letta_client-1.0.0a14 → letta_client-1.0.0a15}/src/letta_client/types/agents/__init__.py

@@ -13,9 +13,11 @@ from .message_role import MessageRole as MessageRole
 from .message_type import MessageType as MessageType
 from .text_content import TextContent as TextContent
 from .user_message import UserMessage as UserMessage
+from .event_message import EventMessage as EventMessage
 from .image_content import ImageContent as ImageContent
 from .letta_response import LettaResponse as LettaResponse
 from .system_message import SystemMessage as SystemMessage
+from .summary_message import SummaryMessage as SummaryMessage
 from .tool_call_delta import ToolCallDelta as ToolCallDelta
 from .file_list_params import FileListParams as FileListParams
 from .tool_list_params import ToolListParams as ToolListParams

letta_client-1.0.0a15/src/letta_client/types/agents/event_message.py

@@ -0,0 +1,35 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["EventMessage"]
+
+
+class EventMessage(BaseModel):
+    id: str
+
+    date: datetime
+
+    event_data: Dict[str, object]
+
+    event_type: Literal["compaction"]
+
+    is_err: Optional[bool] = None
+
+    message_type: Optional[Literal["event"]] = None
+
+    name: Optional[str] = None
+
+    otid: Optional[str] = None
+
+    run_id: Optional[str] = None
+
+    sender_id: Optional[str] = None
+
+    seq_id: Optional[int] = None
+
+    step_id: Optional[str] = None