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

package/resources/agents/messages.d.ts

@@ -4,16 +4,33 @@ import * as ToolsAPI from "../tools.js";
 import * as AgentsAPI from "./agents.js";
 import * as RunsAPI from "../runs/runs.js";
 import { APIPromise } from "../../core/api-promise.js";
+import { ArrayPage, type ArrayPageParams, ObjectPage, PagePromise } from "../../core/pagination.js";
+import { Stream } from "../../core/streaming.js";
 import { RequestOptions } from "../../internal/request-options.js";
 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,14 +39,9 @@ export declare class Messages extends APIResource {
      */
     cancel(agentID: string, body?: MessageCancelParams | null | undefined, options?: RequestOptions): APIPromise<MessageCancelResponse>;
     /**
-     * Resets the messages for an agent
-     */
-    reset(agentID: string, body: MessageResetParams, options?: RequestOptions): APIPromise<AgentsAPI.AgentState>;
-    /**
-     * Process a user message and return the agent's response. This endpoint accepts a
-     * message from a user and processes it through the agent.
+     * Summarize an agent's conversation history.
      */
-    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
@@ -38,18 +50,21 @@ export declare class Messages extends APIResource {
      * 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.
      */
-    stream(agentID: string, body: MessageStreamParams, options?: RequestOptions): APIPromise<unknown>;
-    /**
-     * Summarize an agent's conversation history.
-     */
-    summarize(agentID: string, options?: RequestOptions): APIPromise<void>;
+    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
  */
@@ -61,11 +76,15 @@ export interface ApprovalCreate {
     /**
      * The list of approval responses
      */
-    approvals?: Array<ApprovalCreate.ApprovalReturn | ToolReturn> | null;
+    approvals?: Array<ApprovalReturn | ToolReturn> | null;
     /**
      * @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
      */
@@ -75,26 +94,6 @@ export interface ApprovalCreate {
      */
     type?: 'approval';
 }
-export declare namespace ApprovalCreate {
-    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 representing a request for approval to call a tool (generated by the
  * LLM to trigger tool execution).
@@ -147,7 +146,7 @@ export interface ApprovalResponseMessage {
     /**
      * The list of approval responses
      */
-    approvals?: Array<ApprovalResponseMessage.ApprovalReturn | ToolReturn> | null;
+    approvals?: Array<ApprovalReturn | ToolReturn> | null;
     /**
      * @deprecated Whether the tool has been approved
      */
@@ -168,25 +167,23 @@ export interface ApprovalResponseMessage {
     seq_id?: number | null;
     step_id?: string | null;
 }
-export declare namespace ApprovalResponseMessage {
-    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';
-    }
+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.
@@ -216,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.
@@ -307,187 +324,6 @@ export declare namespace ImageContent {
         type?: 'letta';
     }
 }
-/**
- * Status of the job.
- */
-export type JobStatus = 'created' | 'running' | 'completed' | 'failed' | 'pending' | 'cancelled' | 'expired';
-export type JobType = 'job' | 'run' | 'batch';
-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>;
-    /**
-     * @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;
-    /**
-     * @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;
-    /**
-     * @deprecated 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.
-     */
-    include_return_message_types?: Array<MessageType> | null;
-    /**
-     * Maximum number of steps the agent should take to process the request.
-     */
-    max_steps?: number;
-    /**
-     * @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;
-}
-/**
- * Response object from an agent interaction, consisting of the new messages
- * generated by the agent and usage statistics. The type of the returned messages
- * can be either `Message` or `LettaMessage`, depending on what was specified in
- * the request.
- *
- * Attributes: messages (List[Union[Message, LettaMessage]]): The messages returned
- * by the agent. usage (LettaUsageStatistics): The usage statistics
- */
-export interface LettaResponse {
-    /**
-     * The messages returned by the agent.
-     */
-    messages: Array<LettaMessageUnion>;
-    /**
-     * The stop reason from Letta indicating why agent loop stopped execution.
-     */
-    stop_reason: LettaResponse.StopReason;
-    /**
-     * The usage statistics of the agent.
-     */
-    usage: LettaResponse.Usage;
-}
-export declare namespace LettaResponse {
-    /**
-     * The stop reason from Letta indicating why agent loop stopped execution.
-     */
-    interface StopReason {
-        /**
-         * The reason why execution stopped.
-         */
-        stop_reason: RunsAPI.StopReasonType;
-        /**
-         * The type of the message.
-         */
-        message_type?: 'stop_reason';
-    }
-    /**
-     * The usage statistics of the agent.
-     */
-    interface Usage {
-        /**
-         * 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 interface LettaStreamingRequest {
-    /**
-     * The messages to be sent to the agent.
-     */
-    messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
-    /**
-     * @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;
-    /**
-     * @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.
-     */
-    background?: boolean;
-    /**
-     * @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.
-     */
-    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;
-    /**
-     * @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 type LettaUserMessageContentUnion = TextContent | ImageContent;
 /**
  * Letta's internal representation of a message. Includes methods to convert to/from LLM provider formats.
  *
@@ -510,15 +346,15 @@ export type LettaUserMessageContentUnion = TextContent | ImageContent;
  *
  * t
  */
-export interface Message {
+export interface InternalMessage {
     /**
-     * The role of the participant.
+     * The human-friendly ID of the Message
      */
-    role: MessageRole;
+    id: string;
     /**
-     * The human-friendly ID of the Message
+     * The role of the participant.
      */
-    id?: string;
+    role: MessageRole;
     /**
      * The unique identifier of the agent.
      */
@@ -531,7 +367,7 @@ export interface Message {
     /**
      * The list of approvals for this message.
      */
-    approvals?: Array<Message.ApprovalReturn | Message.LettaSchemasMessageToolReturn> | null;
+    approvals?: Array<ApprovalReturn | InternalMessage.LettaSchemasMessageToolReturn> | null;
     /**
      * Whether tool call is approved.
      */
@@ -543,7 +379,7 @@ export interface Message {
     /**
      * The content of the message.
      */
-    content?: Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | Message.SummarizedReasoningContent> | null;
+    content?: Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | InternalMessage.SummarizedReasoningContent> | null;
     /**
      * The timestamp when the object was created.
      */
@@ -600,50 +436,32 @@ export interface Message {
     /**
      * The list of tool calls requested. Only applicable for role assistant.
      */
-    tool_calls?: Array<Message.ToolCall> | null;
+    tool_calls?: Array<InternalMessage.ToolCall> | null;
     /**
      * Tool execution return information for prior tool calls
      */
-    tool_returns?: Array<Message.ToolReturn> | null;
+    tool_returns?: Array<InternalMessage.ToolReturn> | null;
     /**
      * The timestamp when the object was last updated.
      */
     updated_at?: string | null;
 }
-export declare namespace Message {
-    interface ApprovalReturn {
+export declare namespace InternalMessage {
+    interface LettaSchemasMessageToolReturn {
         /**
-         * Whether the tool has been approved
+         * The status of the tool call
          */
-        approve: boolean;
+        status: 'success' | 'error';
         /**
-         * The ID of the tool call that corresponds to this approval
+         * The function response string
          */
-        tool_call_id: string;
+        func_response?: string | null;
         /**
-         * An optional explanation for the provided approval status
+         * Captured stderr from the tool invocation
          */
-        reason?: string | null;
+        stderr?: Array<string> | null;
         /**
-         * The message type to be created.
-         */
-        type?: 'approval';
-    }
-    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
+         * Captured stdout (e.g. prints, logs) from the tool invocation
          */
         stdout?: Array<string> | null;
         /**
@@ -720,6 +538,334 @@ export declare namespace Message {
         tool_call_id?: unknown;
     }
 }
+/**
+ * Status of the job.
+ */
+export type JobStatus = 'created' | 'running' | 'completed' | 'failed' | 'pending' | 'cancelled' | 'expired';
+export type JobType = 'job' | 'run' | 'batch';
+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';
+}
+export interface LettaRequest {
+    /**
+     * @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;
+    /**
+     * @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;
+    /**
+     * @deprecated 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.
+     */
+    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;
+    /**
+     * 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
+ * can be either `Message` or `LettaMessage`, depending on what was specified in
+ * the request.
+ *
+ * Attributes: messages (List[Union[Message, LettaMessage]]): The messages returned
+ * by the agent. usage (LettaUsageStatistics): The usage statistics
+ */
+export interface LettaResponse {
+    /**
+     * The messages returned by the agent.
+     */
+    messages: Array<Message>;
+    /**
+     * The stop reason from Letta indicating why agent loop stopped execution.
+     */
+    stop_reason: LettaResponse.StopReason;
+    /**
+     * The usage statistics of the agent.
+     */
+    usage: LettaResponse.Usage;
+}
+export declare namespace LettaResponse {
+    /**
+     * The stop reason from Letta indicating why agent loop stopped execution.
+     */
+    interface StopReason {
+        /**
+         * The reason why execution stopped.
+         */
+        stop_reason: RunsAPI.StopReasonType;
+        /**
+         * The type of the message.
+         */
+        message_type?: 'stop_reason';
+    }
+    /**
+     * The usage statistics of the agent.
+     */
+    interface Usage {
+        /**
+         * 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 interface LettaStreamingRequest {
+    /**
+     * @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;
+    /**
+     * @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 (only used when
+     * streaming=true).
+     */
+    background?: boolean;
+    /**
+     * @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 (only used when streaming=true).
+     */
+    include_pings?: boolean;
+    /**
+     * Only return specified message types in the response. If `None` (default) returns
+     * 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 | LettaStreamingRequest.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;
+    /**
+     * 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 LettaStreamingRequest {
+    /**
+     * 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;
+        }
+    }
+}
+/**
+ * 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 {
+    /**
+     * Ping messages are a keep-alive to prevent SSE streams from timing out during
+     * long running requests.
+     */
+    interface LettaPing {
+        /**
+         * The type of the message.
+         */
+        message_type: 'ping';
+    }
+    /**
+     * The stop reason from Letta indicating why agent loop stopped execution.
+     */
+    interface LettaStopReason {
+        /**
+         * The reason why execution stopped.
+         */
+        stop_reason: RunsAPI.StopReasonType;
+        /**
+         * The type of the message.
+         */
+        message_type?: 'stop_reason';
+    }
+    /**
+     * 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.
+     */
+    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';
 /**
@@ -803,26 +949,16 @@ export interface RedactedReasoningContent {
  * 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.
- *
- * Parameters: id (str): The unique identifier of the run (prefixed with 'run-').
- * status (JobStatus): The current status of the run. created_at (datetime): The
- * timestamp when the run was created. completed_at (datetime): The timestamp when
- * the run was completed. agent_id (str): The unique identifier of the agent
- * associated with the run. base_template_id (str): The base template ID that the
- * run belongs to. stop_reason (StopReasonType): The reason why the run was
- * stopped. background (bool): Whether the run was created in background mode.
- * metadata (dict): Additional metadata for the run. request_config
- * (LettaRequestConfig): The request configuration for the run.
  */
 export interface Run {
     /**
-     * The unique identifier of the agent associated with the run.
+     * The human-friendly ID of the Run
      */
-    agent_id: string;
+    id: string;
     /**
-     * The human-friendly ID of the Run
+     * The unique identifier of the agent associated with the run.
      */
-    id?: string;
+    agent_id: string;
     /**
      * Whether the run was created in background mode.
      */
@@ -907,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.
@@ -1098,182 +1251,153 @@ 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 MessageStreamResponse = unknown;
-export type MessageUpdateParams = MessageUpdateParams.UpdateSystemMessage | MessageUpdateParams.UpdateUserMessage | MessageUpdateParams.UpdateReasoningMessage | MessageUpdateParams.UpdateAssistantMessage;
-export declare namespace MessageUpdateParams {
-    interface UpdateSystemMessage {
-        /**
-         * Path param: The ID of the agent in the format 'agent-<uuid4>'
-         */
-        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: The ID of the agent in the format 'agent-<uuid4>'
-         */
-        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: The ID of the agent in the format 'agent-<uuid4>'
-         */
-        agent_id: string;
-        /**
-         * Body param:
-         */
-        reasoning: string;
-        /**
-         * Body param:
-         */
-        message_type?: 'reasoning_message';
-    }
-    interface UpdateAssistantMessage {
-        /**
-         * Path param: The ID of the agent in the format 'agent-<uuid4>'
-         */
-        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 {
-    /**
-     * Message ID cursor for pagination. Returns messages that come after this message
-     * ID in the specified sort order
-     */
-    after?: string | null;
+export type MessageCreateParams = MessageCreateParamsNonStreaming | MessageCreateParamsStreaming;
+export interface MessageCreateParamsBase {
     /**
-     * @deprecated The name of the message argument.
+     * @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;
     /**
-     * @deprecated 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;
     /**
-     * Message ID cursor for pagination. Returns messages that come before this message
-     * ID in the specified sort order
+     * Whether to process the request in the background (only used when
+     * streaming=true).
      */
-    before?: string | null;
+    background?: boolean;
     /**
-     * Group ID to filter messages by.
+     * @deprecated If set to True, enables reasoning before responses or tool calls
+     * from the agent.
      */
-    group_id?: string | null;
+    enable_thinking?: string;
     /**
-     * Whether to include error messages and error statuses. For debugging purposes
-     * only.
+     * Whether to include periodic keepalive ping messages in the stream to prevent
+     * connection timeouts (only used when streaming=true).
      */
-    include_err?: boolean | null;
+    include_pings?: boolean;
     /**
-     * Maximum number of messages to return
+     * Only return specified message types in the response. If `None` (default) returns
+     * all messages.
      */
-    limit?: number | null;
+    include_return_message_types?: Array<MessageType> | null;
     /**
-     * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
-     * newest first
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
      */
-    order?: 'asc' | 'desc';
+    input?: string | Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | MessageCreateParams.SummarizedReasoningContent> | null;
     /**
-     * Field to sort by
+     * Maximum number of steps the agent should take to process the request.
      */
-    order_by?: 'created_at';
+    max_steps?: number;
     /**
-     * @deprecated Whether to use assistant messages
+     * 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;
+    /**
+     * 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 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;
+    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;
+        }
+    }
+    type MessageCreateParamsNonStreaming = MessagesAPI.MessageCreateParamsNonStreaming;
+    type MessageCreateParamsStreaming = MessagesAPI.MessageCreateParamsStreaming;
 }
-export interface MessageResetParams {
+export interface MessageCreateParamsNonStreaming extends MessageCreateParamsBase {
     /**
-     * If true, adds the default initial messages after resetting.
+     * If True, returns a streaming response (Server-Sent Events). If False (default),
+     * returns a complete response.
      */
-    add_default_initial_messages?: boolean;
+    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 {
     /**
-     * @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.
+     * @deprecated The name of the message argument.
      */
     assistant_message_tool_kwarg?: string;
     /**
-     * @deprecated The name of the designated message tool. Still supported for legacy
-     * agent types, but deprecated for letta_v1_agent onward.
+     * @deprecated The name of the designated message tool.
      */
     assistant_message_tool_name?: string;
     /**
-     * @deprecated 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;
     /**
-     * @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.
+     * @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 {
     /**
      * @deprecated The name of the message argument in the designated message tool.
      * Still supported for legacy agent types, but deprecated for letta_v1_agent
@@ -1299,10 +1423,19 @@ 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;
+    /**
+     * 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
@@ -1310,11 +1443,48 @@ export interface MessageSendAsyncParams {
      */
     use_assistant_message?: boolean;
 }
-export interface MessageStreamParams {
+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 {
     /**
      * @deprecated The name of the message argument in the designated message tool.
      * Still supported for legacy agent types, but deprecated for letta_v1_agent
@@ -1327,7 +1497,8 @@ export interface MessageStreamParams {
      */
     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;
     /**
@@ -1337,7 +1508,7 @@ export interface MessageStreamParams {
     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;
     /**
@@ -1345,15 +1516,29 @@ export interface MessageStreamParams {
      * 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;
+    /**
+     * 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
@@ -1361,7 +1546,42 @@ export interface MessageStreamParams {
      */
     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 MessageStreamResponse as MessageStreamResponse, type MessageUpdateParams as MessageUpdateParams, type MessageListParams as MessageListParams, type MessageCancelParams as MessageCancelParams, type MessageResetParams as MessageResetParams, type MessageSendParams as MessageSendParams, type MessageSendAsyncParams as MessageSendAsyncParams, type MessageStreamParams as MessageStreamParams, };
+    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.ts.map