@letta-ai/letta-client 1.0.0-alpha.6 → 1.0.0

package/resources/agents/messages.d.mts

@@ -1,19 +1,36 @@
 import { APIResource } from "../../core/resource.mjs";
 import * as MessagesAPI from "./messages.mjs";
-import * as RunsAPI from "../runs.mjs";
+import * as ToolsAPI from "../tools.mjs";
 import * as AgentsAPI from "./agents.mjs";
-import * as ToolsAPI from "../tools/tools.mjs";
+import * as RunsAPI from "../runs/runs.mjs";
 import { APIPromise } from "../../core/api-promise.mjs";
+import { ArrayPage, type ArrayPageParams, ObjectPage, PagePromise } from "../../core/pagination.mjs";
+import { Stream } from "../../core/streaming.mjs";
 import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Messages extends APIResource {
     /**
-     * Update the details of a message associated with an agent.
+     * Process a user message and return the agent's response. This endpoint accepts a
+     * message from a user and processes it through the agent.
+     *
+     * The response format is controlled by the `streaming` field in the request body:
+     *
+     * - If `streaming=false` (default): Returns a complete LettaResponse with all
+     *   messages
+     * - If `streaming=true`: Returns a Server-Sent Events (SSE) stream
+     *
+     * Additional streaming options (only used when streaming=true):
+     *
+     * - `stream_tokens`: Stream individual tokens instead of complete steps
+     * - `include_pings`: Include keepalive pings to prevent connection timeouts
+     * - `background`: Process the request in the background
      */
-    update(messageID: string, params: MessageUpdateParams, options?: RequestOptions): APIPromise<MessageUpdateResponse>;
+    create(agentID: string, body: MessageCreateParamsNonStreaming, options?: RequestOptions): APIPromise<LettaResponse>;
+    create(agentID: string, body: MessageCreateParamsStreaming, options?: RequestOptions): APIPromise<Stream<LettaStreamingResponse>>;
+    create(agentID: string, body: MessageCreateParamsBase, options?: RequestOptions): APIPromise<Stream<LettaStreamingResponse> | LettaResponse>;
     /**
      * Retrieve message history for an agent.
      */
-    list(agentID: string, query?: MessageListParams | null | undefined, options?: RequestOptions): APIPromise<MessageListResponse>;
+    list(agentID: string, query?: MessageListParams | null | undefined, options?: RequestOptions): PagePromise<MessagesArrayPage, Message>;
     /**
      * Cancel runs associated with an agent. If run_ids are passed in, cancel those in
      * particular.
@@ -22,55 +39,54 @@ export declare class Messages extends APIResource {
      */
     cancel(agentID: string, body?: MessageCancelParams | null | undefined, options?: RequestOptions): APIPromise<MessageCancelResponse>;
     /**
-     * Inspect the raw LLM request payload without sending it.
-     *
-     * This endpoint processes the message through the agent loop up until the LLM
-     * request, then returns the raw request payload that would be sent to the LLM
-     * provider. Useful for debugging and inspection.
+     * Summarize an agent's conversation history.
      */
-    previewRawPayload(agentID: string, body: MessagePreviewRawPayloadParams, options?: RequestOptions): APIPromise<MessagePreviewRawPayloadResponse>;
-    /**
-     * Search messages across the entire organization with optional project and
-     * template filtering. Returns messages with FTS/vector ranks and total RRF score.
-     *
-     * This is a cloud-only feature.
-     */
-    search(body: MessageSearchParams, options?: RequestOptions): APIPromise<MessageSearchResponse>;
-    /**
-     * Process a user message and return the agent's response. This endpoint accepts a
-     * message from a user and processes it through the agent.
-     */
-    send(agentID: string, body: MessageSendParams, options?: RequestOptions): APIPromise<LettaResponse>;
+    compact(agentID: string, options?: RequestOptions): APIPromise<void>;
     /**
      * Asynchronously process a user message and return a run object. The actual
      * processing happens in the background, and the status can be checked using the
      * run ID.
      *
-     * This is "asynchronous" in the sense that it's a background job and explicitly
-     * must be fetched by the run ID. This is more like `send_message_job`
+     * This is "asynchronous" in the sense that it's a background run and explicitly
+     * must be fetched by the run ID.
      */
-    sendAsync(agentID: string, body: MessageSendAsyncParams, options?: RequestOptions): APIPromise<Run>;
+    createAsync(agentID: string, body: MessageCreateAsyncParams, options?: RequestOptions): APIPromise<Run>;
+    /**
+     * Resets the messages for an agent
+     */
+    reset(agentID: string, body: MessageResetParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState | null>;
     /**
      * Process a user message and return the agent's response. This endpoint accepts a
      * message from a user and processes it through the agent. It will stream the steps
      * of the response always, and stream the tokens if 'stream_tokens' is set to True.
      */
-    sendStream(agentID: string, body: MessageSendStreamParams, options?: RequestOptions): APIPromise<unknown>;
+    stream(agentID: string, body: MessageStreamParams, options?: RequestOptions): APIPromise<Stream<LettaStreamingResponse>>;
 }
+export type MessagesArrayPage = ArrayPage<Message>;
+export type RunsArrayPage = ArrayPage<Run>;
+export type InternalMessagesObjectPage = ObjectPage<InternalMessage>;
 /**
  * Input to approve or deny a tool call request
  */
 export interface ApprovalCreate {
     /**
-     * The message ID of the approval request
+     * @deprecated The message ID of the approval request
      */
-    approval_request_id: string;
+    approval_request_id?: string | null;
     /**
-     * Whether the tool has been approved
+     * The list of approval responses
      */
-    approve: boolean;
+    approvals?: Array<ApprovalReturn | ToolReturn> | null;
     /**
-     * An optional explanation for the provided approval status
+     * @deprecated Whether the tool has been approved
+     */
+    approve?: boolean | null;
+    /**
+     * The multi-agent group that the message was sent in
+     */
+    group_id?: string | null;
+    /**
+     * @deprecated An optional explanation for the provided approval status
      */
     reason?: string | null;
     /**
@@ -90,7 +106,7 @@ export interface ApprovalRequestMessage {
     id: string;
     date: string;
     /**
-     * The tool call that has been requested by the llm to run
+     * @deprecated The tool call that has been requested by the llm to run
      */
     tool_call: ToolCall | ToolCallDelta;
     is_err?: boolean | null;
@@ -104,6 +120,11 @@ export interface ApprovalRequestMessage {
     sender_id?: string | null;
     seq_id?: number | null;
     step_id?: string | null;
+    /**
+     * The tool calls that have been requested by the llm to run, which are pending
+     * approval
+     */
+    tool_calls?: Array<ToolCall> | ToolCallDelta | null;
 }
 /**
  * A message representing a response form the user indicating whether a tool has
@@ -117,15 +138,19 @@ export interface ApprovalRequestMessage {
  */
 export interface ApprovalResponseMessage {
     id: string;
+    date: string;
     /**
-     * The message ID of the approval request
+     * @deprecated The message ID of the approval request
      */
-    approval_request_id: string;
+    approval_request_id?: string | null;
     /**
-     * Whether the tool has been approved
+     * The list of approval responses
      */
-    approve: boolean;
-    date: string;
+    approvals?: Array<ApprovalReturn | ToolReturn> | null;
+    /**
+     * @deprecated Whether the tool has been approved
+     */
+    approve?: boolean | null;
     is_err?: boolean | null;
     /**
      * The type of the message.
@@ -134,7 +159,7 @@ export interface ApprovalResponseMessage {
     name?: string | null;
     otid?: string | null;
     /**
-     * An optional explanation for the provided approval status
+     * @deprecated An optional explanation for the provided approval status
      */
     reason?: string | null;
     run_id?: string | null;
@@ -142,6 +167,24 @@ export interface ApprovalResponseMessage {
     seq_id?: number | null;
     step_id?: string | null;
 }
+export interface ApprovalReturn {
+    /**
+     * Whether the tool has been approved
+     */
+    approve: boolean;
+    /**
+     * The ID of the tool call that corresponds to this approval
+     */
+    tool_call_id: string;
+    /**
+     * An optional explanation for the provided approval status
+     */
+    reason?: string | null;
+    /**
+     * The message type to be created.
+     */
+    type?: 'approval';
+}
 /**
  * A message sent by the LLM in response to user input. Used in the LLM context.
  *
@@ -170,6 +213,26 @@ export interface AssistantMessage {
     seq_id?: number | null;
     step_id?: string | null;
 }
+/**
+ * A message for notifying the developer that an event that has occured (e.g. a
+ * compaction). Events are NOT part of the context window.
+ */
+export interface EventMessage {
+    id: string;
+    date: string;
+    event_data: {
+        [key: string]: unknown;
+    };
+    event_type: 'compaction';
+    is_err?: boolean | null;
+    message_type?: 'event';
+    name?: string | null;
+    otid?: string | null;
+    run_id?: string | null;
+    sender_id?: string | null;
+    seq_id?: number | null;
+    step_id?: string | null;
+}
 /**
  * Representation of an agent's internal reasoning where reasoning content has been
  * hidden from the response.
@@ -261,6 +324,220 @@ export declare namespace ImageContent {
         type?: 'letta';
     }
 }
+/**
+ * Letta's internal representation of a message. Includes methods to convert to/from LLM provider formats.
+ *
+ *     Attributes:
+ *         id (str): The unique identifier of the message.
+ *         role (MessageRole): The role of the participant.
+ *         text (str): The text of the message.
+ *         user_id (str): The unique identifier of the user.
+ *         agent_id (str): The unique identifier of the agent.
+ *         model (str): The model used to make the function call.
+ *         name (str): The name of the participant.
+ *         created_at (datetime): The time the message was created.
+ *         tool_calls (List[OpenAIToolCall,]): The list of tool calls requested.
+ *         tool_call_id (str): The id of the tool call.
+ *         step_id (str): The id of the step that this message was created in.
+ *         otid (str): The offline threading id associated with this message.
+ *         tool_returns (List[ToolReturn]): The list of tool returns requested.
+ *         group_id (str): The multi-agent group that the message was sent in.
+ *         sender_id (str): The id of the sender of the message, can be an identity id or agent id.
+ *
+ * t
+ */
+export interface InternalMessage {
+    /**
+     * The human-friendly ID of the Message
+     */
+    id: string;
+    /**
+     * The role of the participant.
+     */
+    role: MessageRole;
+    /**
+     * The unique identifier of the agent.
+     */
+    agent_id?: string | null;
+    /**
+     * The id of the approval request if this message is associated with a tool call
+     * request.
+     */
+    approval_request_id?: string | null;
+    /**
+     * The list of approvals for this message.
+     */
+    approvals?: Array<ApprovalReturn | InternalMessage.LettaSchemasMessageToolReturn> | null;
+    /**
+     * Whether tool call is approved.
+     */
+    approve?: boolean | null;
+    /**
+     * The id of the LLMBatchItem that this message is associated with
+     */
+    batch_item_id?: string | null;
+    /**
+     * The content of the message.
+     */
+    content?: Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | InternalMessage.SummarizedReasoningContent> | null;
+    /**
+     * The timestamp when the object was created.
+     */
+    created_at?: string;
+    /**
+     * The id of the user that made this object.
+     */
+    created_by_id?: string | null;
+    /**
+     * The reason the tool call request was denied.
+     */
+    denial_reason?: string | null;
+    /**
+     * The multi-agent group that the message was sent in
+     */
+    group_id?: string | null;
+    /**
+     * Whether this message is part of an error step. Used only for debugging purposes.
+     */
+    is_err?: boolean | null;
+    /**
+     * The id of the user that made this object.
+     */
+    last_updated_by_id?: string | null;
+    /**
+     * The model used to make the function call.
+     */
+    model?: string | null;
+    /**
+     * For role user/assistant: the (optional) name of the participant. For role
+     * tool/function: the name of the function called.
+     */
+    name?: string | null;
+    /**
+     * The offline threading id associated with this message
+     */
+    otid?: string | null;
+    /**
+     * The id of the run that this message was created in.
+     */
+    run_id?: string | null;
+    /**
+     * The id of the sender of the message, can be an identity id or agent id
+     */
+    sender_id?: string | null;
+    /**
+     * The id of the step that this message was created in.
+     */
+    step_id?: string | null;
+    /**
+     * The ID of the tool call. Only applicable for role tool.
+     */
+    tool_call_id?: string | null;
+    /**
+     * The list of tool calls requested. Only applicable for role assistant.
+     */
+    tool_calls?: Array<InternalMessage.ToolCall> | null;
+    /**
+     * Tool execution return information for prior tool calls
+     */
+    tool_returns?: Array<InternalMessage.ToolReturn> | null;
+    /**
+     * The timestamp when the object was last updated.
+     */
+    updated_at?: string | null;
+}
+export declare namespace InternalMessage {
+    interface LettaSchemasMessageToolReturn {
+        /**
+         * The status of the tool call
+         */
+        status: 'success' | 'error';
+        /**
+         * The function response string
+         */
+        func_response?: string | null;
+        /**
+         * Captured stderr from the tool invocation
+         */
+        stderr?: Array<string> | null;
+        /**
+         * Captured stdout (e.g. prints, logs) from the tool invocation
+         */
+        stdout?: Array<string> | null;
+        /**
+         * The ID for the tool call
+         */
+        tool_call_id?: unknown;
+    }
+    /**
+     * The style of reasoning content returned by the OpenAI Responses API
+     */
+    interface SummarizedReasoningContent {
+        /**
+         * The unique identifier for this reasoning step.
+         */
+        id: string;
+        /**
+         * Summaries of the reasoning content.
+         */
+        summary: Array<SummarizedReasoningContent.Summary>;
+        /**
+         * The encrypted reasoning content.
+         */
+        encrypted_content?: string;
+        /**
+         * Indicates this is a summarized reasoning step.
+         */
+        type?: 'summarized_reasoning';
+    }
+    namespace SummarizedReasoningContent {
+        interface Summary {
+            /**
+             * The index of the summary part.
+             */
+            index: number;
+            /**
+             * The text of the summary part.
+             */
+            text: string;
+        }
+    }
+    interface ToolCall {
+        id: string;
+        function: ToolCall.Function;
+        type: 'function';
+        [k: string]: unknown;
+    }
+    namespace ToolCall {
+        interface Function {
+            arguments: string;
+            name: string;
+            [k: string]: unknown;
+        }
+    }
+    interface ToolReturn {
+        /**
+         * The status of the tool call
+         */
+        status: 'success' | 'error';
+        /**
+         * The function response string
+         */
+        func_response?: string | null;
+        /**
+         * Captured stderr from the tool invocation
+         */
+        stderr?: Array<string> | null;
+        /**
+         * Captured stdout (e.g. prints, logs) from the tool invocation
+         */
+        stdout?: Array<string> | null;
+        /**
+         * The ID for the tool call
+         */
+        tool_call_id?: unknown;
+    }
+}
 /**
  * Status of the job.
  */
@@ -271,35 +548,30 @@ export interface LettaAssistantMessageContentUnion {
      * The text content of the message.
      */
     text: string;
+    /**
+     * Stores a unique identifier for any reasoning associated with this text content.
+     */
+    signature?: string | null;
     /**
      * The type of the message.
      */
     type?: 'text';
 }
-/**
- * A message generated by the system. Never streamed back on a response, only used
- * for cursor pagination.
- *
- * Args: id (str): The ID of the message date (datetime): The date the message was
- * created in ISO format name (Optional[str]): The name of the sender of the
- * message content (str): The message content sent by the system
- */
-export type LettaMessageUnion = SystemMessage | UserMessage | ReasoningMessage | HiddenReasoningMessage | ToolCallMessage | ToolsAPI.ToolReturnMessage | AssistantMessage | ApprovalRequestMessage | ApprovalResponseMessage;
 export interface LettaRequest {
     /**
-     * The messages to be sent to the agent.
-     */
-    messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
-    /**
-     * The name of the message argument in the designated message tool.
+     * @deprecated The name of the message argument in the designated message tool.
+     * Still supported for legacy agent types, but deprecated for letta_v1_agent
+     * onward.
      */
     assistant_message_tool_kwarg?: string;
     /**
-     * The name of the designated message tool.
+     * @deprecated The name of the designated message tool. Still supported for legacy
+     * agent types, but deprecated for letta_v1_agent onward.
      */
     assistant_message_tool_name?: string;
     /**
-     * If set to True, enables reasoning before responses or tool calls from the agent.
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
      */
     enable_thinking?: string;
     /**
@@ -307,16 +579,61 @@ export interface LettaRequest {
      * all messages.
      */
     include_return_message_types?: Array<MessageType> | null;
+    /**
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
+     */
+    input?: string | Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | LettaRequest.SummarizedReasoningContent> | null;
     /**
      * Maximum number of steps the agent should take to process the request.
      */
     max_steps?: number;
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * The messages to be sent to the agent.
+     */
+    messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
+    /**
+     * @deprecated 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.
      */
     use_assistant_message?: boolean;
 }
+export declare namespace LettaRequest {
+    /**
+     * The style of reasoning content returned by the OpenAI Responses API
+     */
+    interface SummarizedReasoningContent {
+        /**
+         * The unique identifier for this reasoning step.
+         */
+        id: string;
+        /**
+         * Summaries of the reasoning content.
+         */
+        summary: Array<SummarizedReasoningContent.Summary>;
+        /**
+         * The encrypted reasoning content.
+         */
+        encrypted_content?: string;
+        /**
+         * Indicates this is a summarized reasoning step.
+         */
+        type?: 'summarized_reasoning';
+    }
+    namespace SummarizedReasoningContent {
+        interface Summary {
+            /**
+             * The index of the summary part.
+             */
+            index: number;
+            /**
+             * The text of the summary part.
+             */
+            text: string;
+        }
+    }
+}
 /**
  * Response object from an agent interaction, consisting of the new messages
  * generated by the agent and usage statistics. The type of the returned messages
@@ -330,7 +647,7 @@ export interface LettaResponse {
     /**
      * The messages returned by the agent.
      */
-    messages: Array<LettaMessageUnion>;
+    messages: Array<Message>;
     /**
      * The stop reason from Letta indicating why agent loop stopped execution.
      */
@@ -375,10 +692,6 @@ export declare namespace LettaResponse {
          * The number of steps taken by the agent.
          */
         step_count?: number;
-        /**
-         * The messages generated per step
-         */
-        steps_messages?: Array<Array<MessagesAPI.Message>> | null;
         /**
          * The total number of tokens processed by the agent.
          */
@@ -387,28 +700,29 @@ export declare namespace LettaResponse {
 }
 export interface LettaStreamingRequest {
     /**
-     * The messages to be sent to the agent.
-     */
-    messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
-    /**
-     * The name of the message argument in the designated message tool.
+     * @deprecated The name of the message argument in the designated message tool.
+     * Still supported for legacy agent types, but deprecated for letta_v1_agent
+     * onward.
      */
     assistant_message_tool_kwarg?: string;
     /**
-     * The name of the designated message tool.
+     * @deprecated The name of the designated message tool. Still supported for legacy
+     * agent types, but deprecated for letta_v1_agent onward.
      */
     assistant_message_tool_name?: string;
     /**
-     * Whether to process the request in the background.
+     * Whether to process the request in the background (only used when
+     * streaming=true).
      */
     background?: boolean;
     /**
-     * If set to True, enables reasoning before responses or tool calls from the agent.
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
      */
     enable_thinking?: string;
     /**
      * Whether to include periodic keepalive ping messages in the stream to prevent
-     * connection timeouts.
+     * connection timeouts (only used when streaming=true).
      */
     include_pings?: boolean;
     /**
@@ -417,158 +731,160 @@ export interface LettaStreamingRequest {
      */
     include_return_message_types?: Array<MessageType> | null;
     /**
-     * Maximum number of steps the agent should take to process the request.
-     */
-    max_steps?: number;
-    /**
-     * Flag to determine if individual tokens should be streamed, rather than streaming
-     * per step.
-     */
-    stream_tokens?: boolean;
-    /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
-     */
-    use_assistant_message?: boolean;
-}
-export type LettaUserMessageContentUnion = TextContent | ImageContent;
-/**
- * Letta's internal representation of a message. Includes methods to convert to/from LLM provider formats.
- *
- *     Attributes:
- *         id (str): The unique identifier of the message.
- *         role (MessageRole): The role of the participant.
- *         text (str): The text of the message.
- *         user_id (str): The unique identifier of the user.
- *         agent_id (str): The unique identifier of the agent.
- *         model (str): The model used to make the function call.
- *         name (str): The name of the participant.
- *         created_at (datetime): The time the message was created.
- *         tool_calls (List[OpenAIToolCall,]): The list of tool calls requested.
- *         tool_call_id (str): The id of the tool call.
- *         step_id (str): The id of the step that this message was created in.
- *         otid (str): The offline threading id associated with this message.
- *         tool_returns (List[ToolReturn]): The list of tool returns requested.
- *         group_id (str): The multi-agent group that the message was sent in.
- *         sender_id (str): The id of the sender of the message, can be an identity id or agent id.
- *
- * t
- */
-export interface Message {
-    /**
-     * The role of the participant.
-     */
-    role: MessageRole;
-    /**
-     * The human-friendly ID of the Message
-     */
-    id?: string;
-    /**
-     * The unique identifier of the agent.
-     */
-    agent_id?: string | null;
-    /**
-     * The id of the approval request if this message is associated with a tool call
-     * request.
-     */
-    approval_request_id?: string | null;
-    /**
-     * Whether tool call is approved.
-     */
-    approve?: boolean | null;
-    /**
-     * The id of the LLMBatchItem that this message is associated with
-     */
-    batch_item_id?: string | null;
-    /**
-     * The content of the message.
-     */
-    content?: Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent> | null;
-    /**
-     * The timestamp when the object was created.
-     */
-    created_at?: string;
-    /**
-     * The id of the user that made this object.
-     */
-    created_by_id?: string | null;
-    /**
-     * The reason the tool call request was denied.
-     */
-    denial_reason?: string | null;
-    /**
-     * The multi-agent group that the message was sent in
-     */
-    group_id?: string | null;
-    /**
-     * Whether this message is part of an error step. Used only for debugging purposes.
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
      */
-    is_err?: boolean | null;
+    input?: string | Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | LettaStreamingRequest.SummarizedReasoningContent> | null;
     /**
-     * The id of the user that made this object.
-     */
-    last_updated_by_id?: string | null;
-    /**
-     * The model used to make the function call.
+     * Maximum number of steps the agent should take to process the request.
      */
-    model?: string | null;
+    max_steps?: number;
     /**
-     * For role user/assistant: the (optional) name of the participant. For role
-     * tool/function: the name of the function called.
+     * The messages to be sent to the agent.
      */
-    name?: string | null;
+    messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
     /**
-     * The offline threading id associated with this message
+     * Flag to determine if individual tokens should be streamed, rather than streaming
+     * per step (only used when streaming=true).
      */
-    otid?: string | null;
+    stream_tokens?: boolean;
     /**
-     * The id of the sender of the message, can be an identity id or agent id
+     * If True, returns a streaming response (Server-Sent Events). If False (default),
+     * returns a complete response.
      */
-    sender_id?: string | null;
+    streaming?: boolean;
     /**
-     * The id of the step that this message was created in.
+     * @deprecated 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.
      */
-    step_id?: string | null;
+    use_assistant_message?: boolean;
+}
+export declare namespace LettaStreamingRequest {
     /**
-     * The ID of the tool call. Only applicable for role tool.
+     * The style of reasoning content returned by the OpenAI Responses API
      */
-    tool_call_id?: string | null;
+    interface SummarizedReasoningContent {
+        /**
+         * The unique identifier for this reasoning step.
+         */
+        id: string;
+        /**
+         * Summaries of the reasoning content.
+         */
+        summary: Array<SummarizedReasoningContent.Summary>;
+        /**
+         * The encrypted reasoning content.
+         */
+        encrypted_content?: string;
+        /**
+         * Indicates this is a summarized reasoning step.
+         */
+        type?: 'summarized_reasoning';
+    }
+    namespace SummarizedReasoningContent {
+        interface Summary {
+            /**
+             * The index of the summary part.
+             */
+            index: number;
+            /**
+             * The text of the summary part.
+             */
+            text: string;
+        }
+    }
+}
+/**
+ * Streaming response type for Server-Sent Events (SSE) endpoints. Each event in
+ * the stream will be one of these types.
+ */
+export type LettaStreamingResponse = SystemMessage | UserMessage | ReasoningMessage | HiddenReasoningMessage | ToolCallMessage | ToolsAPI.ToolReturnMessage | AssistantMessage | ApprovalRequestMessage | ApprovalResponseMessage | LettaStreamingResponse.LettaPing | LettaStreamingResponse.LettaStopReason | LettaStreamingResponse.LettaUsageStatistics;
+export declare namespace LettaStreamingResponse {
     /**
-     * The list of tool calls requested. Only applicable for role assistant.
+     * Ping messages are a keep-alive to prevent SSE streams from timing out during
+     * long running requests.
      */
-    tool_calls?: Array<Message.ToolCall> | null;
+    interface LettaPing {
+        /**
+         * The type of the message.
+         */
+        message_type: 'ping';
+    }
     /**
-     * Tool execution return information for prior tool calls
+     * The stop reason from Letta indicating why agent loop stopped execution.
      */
-    tool_returns?: Array<ToolReturn> | null;
+    interface LettaStopReason {
+        /**
+         * The reason why execution stopped.
+         */
+        stop_reason: RunsAPI.StopReasonType;
+        /**
+         * The type of the message.
+         */
+        message_type?: 'stop_reason';
+    }
     /**
-     * The timestamp when the object was last updated.
+     * Usage statistics for the agent interaction.
+     *
+     * Attributes: completion_tokens (int): The number of tokens generated by the
+     * agent. prompt_tokens (int): The number of tokens in the prompt. total_tokens
+     * (int): The total number of tokens processed by the agent. step_count (int): The
+     * number of steps taken by the agent.
      */
-    updated_at?: string | null;
-}
-export declare namespace Message {
-    interface ToolCall {
-        id: string;
-        function: ToolCall.Function;
-        type: 'function';
-        [k: string]: unknown;
-    }
-    namespace ToolCall {
-        interface Function {
-            arguments: string;
-            name: string;
-            [k: string]: unknown;
-        }
+    interface LettaUsageStatistics {
+        /**
+         * The number of tokens generated by the agent.
+         */
+        completion_tokens?: number;
+        message_type?: 'usage_statistics';
+        /**
+         * The number of tokens in the prompt.
+         */
+        prompt_tokens?: number;
+        /**
+         * The background task run IDs associated with the agent interaction
+         */
+        run_ids?: Array<string> | null;
+        /**
+         * The number of steps taken by the agent.
+         */
+        step_count?: number;
+        /**
+         * The total number of tokens processed by the agent.
+         */
+        total_tokens?: number;
     }
 }
+export type LettaUserMessageContentUnion = TextContent | ImageContent;
+/**
+ * A message generated by the system. Never streamed back on a response, only used
+ * for cursor pagination.
+ *
+ * Args: id (str): The ID of the message date (datetime): The date the message was
+ * created in ISO format name (Optional[str]): The name of the sender of the
+ * message content (str): The message content sent by the system
+ */
+export type Message = SystemMessage | UserMessage | ReasoningMessage | HiddenReasoningMessage | ToolCallMessage | ToolsAPI.ToolReturnMessage | AssistantMessage | ApprovalRequestMessage | ApprovalResponseMessage | SummaryMessage | EventMessage;
 export type MessageRole = 'assistant' | 'user' | 'tool' | 'function' | 'system' | 'approval';
 export type MessageType = 'system_message' | 'user_message' | 'assistant_message' | 'reasoning_message' | 'hidden_reasoning_message' | 'tool_call_message' | 'tool_return_message' | 'approval_request_message' | 'approval_response_message';
+/**
+ * A placeholder for reasoning content we know is present, but isn't returned by
+ * the provider (e.g. OpenAI GPT-5 on ChatCompletions)
+ */
 export interface OmittedReasoningContent {
+    /**
+     * A unique identifier for this reasoning step.
+     */
+    signature?: string | null;
     /**
      * Indicates this is an omitted reasoning step.
      */
     type?: 'omitted_reasoning';
 }
+/**
+ * Sent via the Anthropic Messages API
+ */
 export interface ReasoningContent {
     /**
      * Whether the reasoning content was generated by a reasoner model that processed
@@ -616,6 +932,9 @@ export interface ReasoningMessage {
     source?: 'reasoner_model' | 'non_reasoner_model';
     step_id?: string | null;
 }
+/**
+ * Sent via the Anthropic Messages API
+ */
 export interface RedactedReasoningContent {
     /**
      * The redacted or filtered intermediate reasoning content.
@@ -627,20 +946,27 @@ export interface RedactedReasoningContent {
     type?: 'redacted_reasoning';
 }
 /**
- * Representation of a run, which is a job with a 'run' prefix in its ID. Inherits
- * all fields and behavior from Job except for the ID prefix.
- *
- * Parameters: id (str): The unique identifier of the run (prefixed with 'run-').
- * status (JobStatus): The status of the run. created_at (datetime): The unix
- * timestamp of when the run was created. completed_at (datetime): The unix
- * timestamp of when the run was completed. user_id (str): The unique identifier of
- * the user associated with the run.
+ * Representation of a run - a conversation or processing session for an agent.
+ * Runs track when agents process messages and maintain the relationship between
+ * agents, steps, and messages.
  */
 export interface Run {
     /**
      * The human-friendly ID of the Run
      */
-    id?: string;
+    id: string;
+    /**
+     * The unique identifier of the agent associated with the run.
+     */
+    agent_id: string;
+    /**
+     * Whether the run was created in background mode.
+     */
+    background?: boolean | null;
+    /**
+     * The base template ID that the run belongs to.
+     */
+    base_template_id?: string | null;
     /**
      * Optional error message from attempting to POST the callback endpoint.
      */
@@ -654,28 +980,19 @@ export interface Run {
      */
     callback_status_code?: number | null;
     /**
-     * If set, POST to this URL when the job completes.
+     * If set, POST to this URL when the run completes.
      */
     callback_url?: string | null;
     /**
-     * The unix timestamp of when the job was completed.
+     * The timestamp when the run was completed.
      */
     completed_at?: string | null;
     /**
-     * The unix timestamp of when the job was created.
+     * The timestamp when the run was created.
      */
     created_at?: string;
     /**
-     * The id of the user that made this object.
-     */
-    created_by_id?: string | null;
-    job_type?: JobType;
-    /**
-     * The id of the user that made this object.
-     */
-    last_updated_by_id?: string | null;
-    /**
-     * The metadata of the job.
+     * Additional metadata for the run.
      */
     metadata?: {
         [key: string]: unknown;
@@ -685,9 +1002,9 @@ export interface Run {
      */
     request_config?: Run.RequestConfig | null;
     /**
-     * The status of the job.
+     * The current status of the run.
      */
-    status?: JobStatus;
+    status?: 'created' | 'running' | 'completed' | 'failed' | 'cancelled';
     /**
      * The reason why the run was stopped.
      */
@@ -700,10 +1017,6 @@ export interface Run {
      * Time to first token for a run in nanoseconds
      */
     ttft_ns?: number | null;
-    /**
-     * The timestamp when the object was last updated.
-     */
-    updated_at?: string | null;
 }
 export declare namespace Run {
     /**
@@ -730,6 +1043,23 @@ export declare namespace Run {
         use_assistant_message?: boolean;
     }
 }
+/**
+ * A message representing a summary of the conversation. Sent to the LLM as a user
+ * or system message depending on the provider.
+ */
+export interface SummaryMessage {
+    id: string;
+    date: string;
+    summary: string;
+    is_err?: boolean | null;
+    message_type?: 'summary';
+    name?: string | null;
+    otid?: string | null;
+    run_id?: string | null;
+    sender_id?: string | null;
+    seq_id?: number | null;
+    step_id?: string | null;
+}
 /**
  * A message generated by the system. Never streamed back on a response, only used
  * for cursor pagination.
@@ -762,6 +1092,10 @@ export interface TextContent {
      * The text content of the message.
      */
     text: string;
+    /**
+     * Stores a unique identifier for any reasoning associated with this text content.
+     */
+    signature?: string | null;
     /**
      * The type of the message.
      */
@@ -788,6 +1122,10 @@ export interface ToolCallContent {
      * The name of the tool being called.
      */
     name: string;
+    /**
+     * Stores a unique identifier for any reasoning associated with this tool call.
+     */
+    signature?: string | null;
     /**
      * Indicates this content represents a tool call event.
      */
@@ -809,6 +1147,9 @@ export interface ToolCallDelta {
 export interface ToolCallMessage {
     id: string;
     date: string;
+    /**
+     * @deprecated
+     */
     tool_call: ToolCall | ToolCallDelta;
     is_err?: boolean | null;
     /**
@@ -821,20 +1162,18 @@ export interface ToolCallMessage {
     sender_id?: string | null;
     seq_id?: number | null;
     step_id?: string | null;
+    tool_calls?: Array<ToolCall> | ToolCallDelta | null;
 }
 export interface ToolReturn {
-    /**
-     * The status of the tool call
-     */
     status: 'success' | 'error';
-    /**
-     * Captured stderr from the tool invocation
-     */
+    tool_call_id: string;
+    tool_return: string;
     stderr?: Array<string> | null;
+    stdout?: Array<string> | null;
     /**
-     * Captured stdout (e.g. prints, logs) from the tool invocation
+     * The message type to be created.
      */
-    stdout?: Array<string> | null;
+    type?: 'tool';
 }
 export interface ToolReturnContent {
     /**
@@ -912,312 +1251,162 @@ export interface UserMessage {
     seq_id?: number | null;
     step_id?: string | null;
 }
-/**
- * A message generated by the system. Never streamed back on a response, only used
- * for cursor pagination.
- *
- * Args: id (str): The ID of the message date (datetime): The date the message was
- * created in ISO format name (Optional[str]): The name of the sender of the
- * message content (str): The message content sent by the system
- */
-export type MessageUpdateResponse = SystemMessage | UserMessage | ReasoningMessage | HiddenReasoningMessage | ToolCallMessage | ToolsAPI.ToolReturnMessage | AssistantMessage | ApprovalRequestMessage | ApprovalResponseMessage;
-export type MessageListResponse = Array<LettaMessageUnion>;
 export type MessageCancelResponse = {
     [key: string]: unknown;
 };
-export type MessagePreviewRawPayloadResponse = {
-    [key: string]: unknown;
-};
-export type MessageSearchResponse = Array<MessageSearchResponse.MessageSearchResponseItem>;
-export declare namespace MessageSearchResponse {
+export type MessageCreateParams = MessageCreateParamsNonStreaming | MessageCreateParamsStreaming;
+export interface MessageCreateParamsBase {
     /**
-     * Result from a message search operation with scoring details.
+     * @deprecated The name of the message argument in the designated message tool.
+     * Still supported for legacy agent types, but deprecated for letta_v1_agent
+     * onward.
      */
-    interface MessageSearchResponseItem {
-        /**
-         * The embedded content (LLM-friendly)
-         */
-        embedded_text: string;
-        /**
-         * The raw message object
-         */
-        message: MessagesAPI.Message;
-        /**
-         * Reciprocal Rank Fusion combined score
-         */
-        rrf_score: number;
-        /**
-         * Full-text search rank position if FTS was used
-         */
-        fts_rank?: number | null;
-        /**
-         * Vector search rank position if vector search was used
-         */
-        vector_rank?: number | null;
-    }
-}
-export type MessageSendStreamResponse = unknown;
-export type MessageUpdateParams = MessageUpdateParams.UpdateSystemMessage | MessageUpdateParams.UpdateUserMessage | MessageUpdateParams.UpdateReasoningMessage | MessageUpdateParams.UpdateAssistantMessage;
-export declare namespace MessageUpdateParams {
-    interface UpdateSystemMessage {
-        /**
-         * Path param:
-         */
-        agent_id: string;
-        /**
-         * Body param: The message content sent by the system (can be a string or an array
-         * of multi-modal content parts)
-         */
-        content: string;
-        /**
-         * Body param:
-         */
-        message_type?: 'system_message';
-    }
-    interface UpdateUserMessage {
-        /**
-         * Path param:
-         */
-        agent_id: string;
-        /**
-         * Body param: The message content sent by the user (can be a string or an array of
-         * multi-modal content parts)
-         */
-        content: Array<LettaUserMessageContentUnion> | string;
-        /**
-         * Body param:
-         */
-        message_type?: 'user_message';
-    }
-    interface UpdateReasoningMessage {
-        /**
-         * Path param:
-         */
-        agent_id: string;
-        /**
-         * Body param:
-         */
-        reasoning: string;
-        /**
-         * Body param:
-         */
-        message_type?: 'reasoning_message';
-    }
-    interface UpdateAssistantMessage {
-        /**
-         * Path param:
-         */
-        agent_id: string;
-        /**
-         * Body param: The message content sent by the assistant (can be a string or an
-         * array of content parts)
-         */
-        content: Array<LettaAssistantMessageContentUnion> | string;
-        /**
-         * Body param:
-         */
-        message_type?: 'assistant_message';
-    }
-}
-export interface MessageListParams {
+    assistant_message_tool_kwarg?: string;
     /**
-     * Message after which to retrieve the returned messages.
+     * @deprecated The name of the designated message tool. Still supported for legacy
+     * agent types, but deprecated for letta_v1_agent onward.
      */
-    after?: string | null;
+    assistant_message_tool_name?: string;
     /**
-     * The name of the message argument.
+     * Whether to process the request in the background (only used when
+     * streaming=true).
      */
-    assistant_message_tool_kwarg?: string;
+    background?: boolean;
     /**
-     * The name of the designated message tool.
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
      */
-    assistant_message_tool_name?: string;
+    enable_thinking?: string;
     /**
-     * Message before which to retrieve the returned messages.
+     * Whether to include periodic keepalive ping messages in the stream to prevent
+     * connection timeouts (only used when streaming=true).
      */
-    before?: string | null;
+    include_pings?: boolean;
     /**
-     * Group ID to filter messages by.
+     * Only return specified message types in the response. If `None` (default) returns
+     * all messages.
      */
-    group_id?: string | null;
+    include_return_message_types?: Array<MessageType> | null;
     /**
-     * Whether to include error messages and error statuses. For debugging purposes
-     * only.
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
      */
-    include_err?: boolean | null;
+    input?: string | Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | MessageCreateParams.SummarizedReasoningContent> | null;
+    /**
+     * Maximum number of steps the agent should take to process the request.
+     */
+    max_steps?: number;
+    /**
+     * The messages to be sent to the agent.
+     */
+    messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
+    /**
+     * Flag to determine if individual tokens should be streamed, rather than streaming
+     * per step (only used when streaming=true).
+     */
+    stream_tokens?: boolean;
     /**
-     * Maximum number of messages to retrieve.
+     * If True, returns a streaming response (Server-Sent Events). If False (default),
+     * returns a complete response.
      */
-    limit?: number;
+    streaming?: boolean;
     /**
-     * Whether to use assistant messages
+     * @deprecated 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.
      */
     use_assistant_message?: boolean;
 }
-export interface MessageCancelParams {
+export declare namespace MessageCreateParams {
     /**
-     * Optional list of run IDs to cancel
+     * The style of reasoning content returned by the OpenAI Responses API
      */
-    run_ids?: Array<string> | null;
-}
-export type MessagePreviewRawPayloadParams = MessagePreviewRawPayloadParams.LettaRequest | MessagePreviewRawPayloadParams.LettaStreamingRequest;
-export declare namespace MessagePreviewRawPayloadParams {
-    interface LettaRequest {
-        /**
-         * The messages to be sent to the agent.
-         */
-        messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
-        /**
-         * The name of the message argument in the designated message tool.
-         */
-        assistant_message_tool_kwarg?: string;
-        /**
-         * The name of the designated message tool.
-         */
-        assistant_message_tool_name?: string;
+    interface SummarizedReasoningContent {
         /**
-         * If set to True, enables reasoning before responses or tool calls from the agent.
+         * The unique identifier for this reasoning step.
          */
-        enable_thinking?: string;
+        id: string;
         /**
-         * Only return specified message types in the response. If `None` (default) returns
-         * all messages.
+         * Summaries of the reasoning content.
          */
-        include_return_message_types?: Array<MessageType> | null;
+        summary: Array<SummarizedReasoningContent.Summary>;
         /**
-         * Maximum number of steps the agent should take to process the request.
+         * The encrypted reasoning content.
          */
-        max_steps?: number;
+        encrypted_content?: string;
         /**
-         * Whether the server should parse specific tool call arguments (default
-         * `send_message`) as `AssistantMessage` objects.
+         * Indicates this is a summarized reasoning step.
          */
-        use_assistant_message?: boolean;
+        type?: 'summarized_reasoning';
     }
-    interface LettaStreamingRequest {
-        /**
-         * The messages to be sent to the agent.
-         */
-        messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
-        /**
-         * The name of the message argument in the designated message tool.
-         */
-        assistant_message_tool_kwarg?: string;
-        /**
-         * The name of the designated message tool.
-         */
-        assistant_message_tool_name?: string;
-        /**
-         * Whether to process the request in the background.
-         */
-        background?: boolean;
-        /**
-         * If set to True, enables reasoning before responses or tool calls from the agent.
-         */
-        enable_thinking?: string;
-        /**
-         * Whether to include periodic keepalive ping messages in the stream to prevent
-         * connection timeouts.
-         */
-        include_pings?: boolean;
-        /**
-         * Only return specified message types in the response. If `None` (default) returns
-         * all messages.
-         */
-        include_return_message_types?: Array<MessageType> | null;
-        /**
-         * Maximum number of steps the agent should take to process the request.
-         */
-        max_steps?: number;
-        /**
-         * Flag to determine if individual tokens should be streamed, rather than streaming
-         * per step.
-         */
-        stream_tokens?: boolean;
-        /**
-         * Whether the server should parse specific tool call arguments (default
-         * `send_message`) as `AssistantMessage` objects.
-         */
-        use_assistant_message?: boolean;
+    namespace SummarizedReasoningContent {
+        interface Summary {
+            /**
+             * The index of the summary part.
+             */
+            index: number;
+            /**
+             * The text of the summary part.
+             */
+            text: string;
+        }
     }
+    type MessageCreateParamsNonStreaming = MessagesAPI.MessageCreateParamsNonStreaming;
+    type MessageCreateParamsStreaming = MessagesAPI.MessageCreateParamsStreaming;
 }
-export interface MessageSearchParams {
-    /**
-     * Filter messages created on or before this date
-     */
-    end_date?: string | null;
-    /**
-     * Maximum number of results to return
-     */
-    limit?: number;
-    /**
-     * Filter messages by project ID
-     */
-    project_id?: string | null;
-    /**
-     * Text query for full-text search
-     */
-    query?: string | null;
-    /**
-     * Filter messages by role
-     */
-    roles?: Array<MessageRole> | null;
-    /**
-     * Search mode to use
-     */
-    search_mode?: 'vector' | 'fts' | 'hybrid';
-    /**
-     * Filter messages created after this date
-     */
-    start_date?: string | null;
+export interface MessageCreateParamsNonStreaming extends MessageCreateParamsBase {
     /**
-     * Filter messages by template ID
+     * If True, returns a streaming response (Server-Sent Events). If False (default),
+     * returns a complete response.
      */
-    template_id?: string | null;
+    streaming?: false;
 }
-export interface MessageSendParams {
+export interface MessageCreateParamsStreaming extends MessageCreateParamsBase {
     /**
-     * The messages to be sent to the agent.
+     * If True, returns a streaming response (Server-Sent Events). If False (default),
+     * returns a complete response.
      */
-    messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
+    streaming: true;
+}
+export interface MessageListParams extends ArrayPageParams {
     /**
-     * The name of the message argument in the designated message tool.
+     * @deprecated The name of the message argument.
      */
     assistant_message_tool_kwarg?: string;
     /**
-     * The name of the designated message tool.
+     * @deprecated The name of the designated message tool.
      */
     assistant_message_tool_name?: string;
     /**
-     * If set to True, enables reasoning before responses or tool calls from the agent.
-     */
-    enable_thinking?: string;
-    /**
-     * Only return specified message types in the response. If `None` (default) returns
-     * all messages.
+     * Group ID to filter messages by.
      */
-    include_return_message_types?: Array<MessageType> | null;
+    group_id?: string | null;
     /**
-     * Maximum number of steps the agent should take to process the request.
+     * Whether to include error messages and error statuses. For debugging purposes
+     * only.
      */
-    max_steps?: number;
+    include_err?: boolean | null;
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * @deprecated Whether to use assistant messages
      */
     use_assistant_message?: boolean;
 }
-export interface MessageSendAsyncParams {
+export interface MessageCancelParams {
     /**
-     * The messages to be sent to the agent.
+     * Optional list of run IDs to cancel
      */
-    messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
+    run_ids?: Array<string> | null;
+}
+export interface MessageCreateAsyncParams {
     /**
-     * The name of the message argument in the designated message tool.
+     * @deprecated The name of the message argument in the designated message tool.
+     * Still supported for legacy agent types, but deprecated for letta_v1_agent
+     * onward.
      */
     assistant_message_tool_kwarg?: string;
     /**
-     * The name of the designated message tool.
+     * @deprecated The name of the designated message tool. Still supported for legacy
+     * agent types, but deprecated for letta_v1_agent onward.
      */
     assistant_message_tool_name?: string;
     /**
@@ -1225,7 +1414,8 @@ export interface MessageSendAsyncParams {
      */
     callback_url?: string | null;
     /**
-     * If set to True, enables reasoning before responses or tool calls from the agent.
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
      */
     enable_thinking?: string;
     /**
@@ -1233,40 +1423,92 @@ export interface MessageSendAsyncParams {
      * all messages.
      */
     include_return_message_types?: Array<MessageType> | null;
+    /**
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
+     */
+    input?: string | Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | MessageCreateAsyncParams.SummarizedReasoningContent> | null;
     /**
      * Maximum number of steps the agent should take to process the request.
      */
     max_steps?: number;
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * The messages to be sent to the agent.
+     */
+    messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
+    /**
+     * @deprecated 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.
      */
     use_assistant_message?: boolean;
 }
-export interface MessageSendStreamParams {
+export declare namespace MessageCreateAsyncParams {
     /**
-     * The messages to be sent to the agent.
+     * The style of reasoning content returned by the OpenAI Responses API
+     */
+    interface SummarizedReasoningContent {
+        /**
+         * The unique identifier for this reasoning step.
+         */
+        id: string;
+        /**
+         * Summaries of the reasoning content.
+         */
+        summary: Array<SummarizedReasoningContent.Summary>;
+        /**
+         * The encrypted reasoning content.
+         */
+        encrypted_content?: string;
+        /**
+         * Indicates this is a summarized reasoning step.
+         */
+        type?: 'summarized_reasoning';
+    }
+    namespace SummarizedReasoningContent {
+        interface Summary {
+            /**
+             * The index of the summary part.
+             */
+            index: number;
+            /**
+             * The text of the summary part.
+             */
+            text: string;
+        }
+    }
+}
+export interface MessageResetParams {
+    /**
+     * If true, adds the default initial messages after resetting.
      */
-    messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
+    add_default_initial_messages?: boolean;
+}
+export interface MessageStreamParams {
     /**
-     * The name of the message argument in the designated message tool.
+     * @deprecated The name of the message argument in the designated message tool.
+     * Still supported for legacy agent types, but deprecated for letta_v1_agent
+     * onward.
      */
     assistant_message_tool_kwarg?: string;
     /**
-     * The name of the designated message tool.
+     * @deprecated The name of the designated message tool. Still supported for legacy
+     * agent types, but deprecated for letta_v1_agent onward.
      */
     assistant_message_tool_name?: string;
     /**
-     * Whether to process the request in the background.
+     * Whether to process the request in the background (only used when
+     * streaming=true).
      */
     background?: boolean;
     /**
-     * If set to True, enables reasoning before responses or tool calls from the agent.
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
      */
     enable_thinking?: string;
     /**
      * Whether to include periodic keepalive ping messages in the stream to prevent
-     * connection timeouts.
+     * connection timeouts (only used when streaming=true).
      */
     include_pings?: boolean;
     /**
@@ -1274,22 +1516,72 @@ export interface MessageSendStreamParams {
      * all messages.
      */
     include_return_message_types?: Array<MessageType> | null;
+    /**
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
+     */
+    input?: string | Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | MessageStreamParams.SummarizedReasoningContent> | null;
     /**
      * Maximum number of steps the agent should take to process the request.
      */
     max_steps?: number;
+    /**
+     * The messages to be sent to the agent.
+     */
+    messages?: Array<AgentsAPI.MessageCreate | ApprovalCreate> | null;
     /**
      * Flag to determine if individual tokens should be streamed, rather than streaming
-     * per step.
+     * per step (only used when streaming=true).
      */
     stream_tokens?: boolean;
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * If True, returns a streaming response (Server-Sent Events). If False (default),
+     * returns a complete response.
+     */
+    streaming?: boolean;
+    /**
+     * @deprecated 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.
      */
     use_assistant_message?: boolean;
 }
+export declare namespace MessageStreamParams {
+    /**
+     * The style of reasoning content returned by the OpenAI Responses API
+     */
+    interface SummarizedReasoningContent {
+        /**
+         * The unique identifier for this reasoning step.
+         */
+        id: string;
+        /**
+         * Summaries of the reasoning content.
+         */
+        summary: Array<SummarizedReasoningContent.Summary>;
+        /**
+         * The encrypted reasoning content.
+         */
+        encrypted_content?: string;
+        /**
+         * Indicates this is a summarized reasoning step.
+         */
+        type?: 'summarized_reasoning';
+    }
+    namespace SummarizedReasoningContent {
+        interface Summary {
+            /**
+             * The index of the summary part.
+             */
+            index: number;
+            /**
+             * The text of the summary part.
+             */
+            text: string;
+        }
+    }
+}
 export declare namespace Messages {
-    export { type ApprovalCreate as ApprovalCreate, type ApprovalRequestMessage as ApprovalRequestMessage, type ApprovalResponseMessage as ApprovalResponseMessage, type AssistantMessage as AssistantMessage, type HiddenReasoningMessage as HiddenReasoningMessage, type ImageContent as ImageContent, type JobStatus as JobStatus, type JobType as JobType, type LettaAssistantMessageContentUnion as LettaAssistantMessageContentUnion, type LettaMessageUnion as LettaMessageUnion, type LettaRequest as LettaRequest, type LettaResponse as LettaResponse, type LettaStreamingRequest as LettaStreamingRequest, type LettaUserMessageContentUnion as LettaUserMessageContentUnion, type Message as Message, type MessageRole as MessageRole, type MessageType as MessageType, type OmittedReasoningContent as OmittedReasoningContent, type ReasoningContent as ReasoningContent, type ReasoningMessage as ReasoningMessage, type RedactedReasoningContent as RedactedReasoningContent, type Run as Run, type SystemMessage as SystemMessage, type TextContent as TextContent, type ToolCall as ToolCall, type ToolCallContent as ToolCallContent, type ToolCallDelta as ToolCallDelta, type ToolCallMessage as ToolCallMessage, type ToolReturn as ToolReturn, type ToolReturnContent as ToolReturnContent, type UpdateAssistantMessage as UpdateAssistantMessage, type UpdateReasoningMessage as UpdateReasoningMessage, type UpdateSystemMessage as UpdateSystemMessage, type UpdateUserMessage as UpdateUserMessage, type UserMessage as UserMessage, type MessageUpdateResponse as MessageUpdateResponse, type MessageListResponse as MessageListResponse, type MessageCancelResponse as MessageCancelResponse, type MessagePreviewRawPayloadResponse as MessagePreviewRawPayloadResponse, type MessageSearchResponse as MessageSearchResponse, type MessageSendStreamResponse as MessageSendStreamResponse, type MessageUpdateParams as MessageUpdateParams, type MessageListParams as MessageListParams, type MessageCancelParams as MessageCancelParams, type MessagePreviewRawPayloadParams as MessagePreviewRawPayloadParams, type MessageSearchParams as MessageSearchParams, type MessageSendParams as MessageSendParams, type MessageSendAsyncParams as MessageSendAsyncParams, type MessageSendStreamParams as MessageSendStreamParams, };
+    export { type ApprovalCreate as ApprovalCreate, type ApprovalRequestMessage as ApprovalRequestMessage, type ApprovalResponseMessage as ApprovalResponseMessage, type ApprovalReturn as ApprovalReturn, type AssistantMessage as AssistantMessage, type EventMessage as EventMessage, type HiddenReasoningMessage as HiddenReasoningMessage, type ImageContent as ImageContent, type InternalMessage as InternalMessage, type JobStatus as JobStatus, type JobType as JobType, type LettaAssistantMessageContentUnion as LettaAssistantMessageContentUnion, type LettaRequest as LettaRequest, type LettaResponse as LettaResponse, type LettaStreamingRequest as LettaStreamingRequest, type LettaStreamingResponse as LettaStreamingResponse, type LettaUserMessageContentUnion as LettaUserMessageContentUnion, type Message as Message, type MessageRole as MessageRole, type MessageType as MessageType, type OmittedReasoningContent as OmittedReasoningContent, type ReasoningContent as ReasoningContent, type ReasoningMessage as ReasoningMessage, type RedactedReasoningContent as RedactedReasoningContent, type Run as Run, type SummaryMessage as SummaryMessage, type SystemMessage as SystemMessage, type TextContent as TextContent, type ToolCall as ToolCall, type ToolCallContent as ToolCallContent, type ToolCallDelta as ToolCallDelta, type ToolCallMessage as ToolCallMessage, type ToolReturn as ToolReturn, type ToolReturnContent as ToolReturnContent, type UpdateAssistantMessage as UpdateAssistantMessage, type UpdateReasoningMessage as UpdateReasoningMessage, type UpdateSystemMessage as UpdateSystemMessage, type UpdateUserMessage as UpdateUserMessage, type UserMessage as UserMessage, type MessageCancelResponse as MessageCancelResponse, type MessagesArrayPage as MessagesArrayPage, type MessageCreateParams as MessageCreateParams, type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming, type MessageCreateParamsStreaming as MessageCreateParamsStreaming, type MessageListParams as MessageListParams, type MessageCancelParams as MessageCancelParams, type MessageCreateAsyncParams as MessageCreateAsyncParams, type MessageResetParams as MessageResetParams, type MessageStreamParams as MessageStreamParams, };
 }
 //# sourceMappingURL=messages.d.mts.map