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

package/resources/agents/messages.d.mts

@@ -1,8 +1,8 @@
 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 { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Messages extends APIResource {
@@ -22,20 +22,9 @@ 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.
-     */
-    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.
+     * Resets the messages for an agent
      */
-    search(body: MessageSearchParams, options?: RequestOptions): APIPromise<MessageSearchResponse>;
+    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.
@@ -46,8 +35,8 @@ export declare class Messages extends APIResource {
      * 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>;
     /**
@@ -55,22 +44,30 @@ export declare class Messages extends APIResource {
      * 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<unknown>;
+    /**
+     * Summarize an agent's conversation history.
+     */
+    summarize(agentID: string, options?: RequestOptions): APIPromise<void>;
 }
 /**
  * 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<ApprovalCreate.ApprovalReturn | ToolReturn> | null;
     /**
-     * An optional explanation for the provided approval status
+     * @deprecated Whether the tool has been approved
+     */
+    approve?: boolean | null;
+    /**
+     * @deprecated An optional explanation for the provided approval status
      */
     reason?: string | null;
     /**
@@ -78,6 +75,26 @@ 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).
@@ -90,7 +107,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 +121,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 +139,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<ApprovalResponseMessage.ApprovalReturn | ToolReturn> | null;
+    /**
+     * @deprecated Whether the tool has been approved
+     */
+    approve?: boolean | null;
     is_err?: boolean | null;
     /**
      * The type of the message.
@@ -134,7 +160,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 +168,26 @@ 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';
+    }
+}
 /**
  * A message sent by the LLM in response to user input. Used in the LLM context.
  *
@@ -271,6 +317,10 @@ 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.
      */
@@ -291,15 +341,19 @@ export interface LettaRequest {
      */
     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;
     /**
@@ -312,8 +366,9 @@ export interface LettaRequest {
      */
     max_steps?: number;
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * @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;
 }
@@ -375,10 +430,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.
          */
@@ -391,11 +442,14 @@ export interface LettaStreamingRequest {
      */
     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;
     /**
@@ -403,7 +457,8 @@ export interface LettaStreamingRequest {
      */
     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;
     /**
@@ -426,8 +481,9 @@ export interface LettaStreamingRequest {
      */
     stream_tokens?: boolean;
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * @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;
 }
@@ -472,6 +528,10 @@ export interface Message {
      * request.
      */
     approval_request_id?: string | null;
+    /**
+     * The list of approvals for this message.
+     */
+    approvals?: Array<Message.ApprovalReturn | Message.LettaSchemasMessageToolReturn> | null;
     /**
      * Whether tool call is approved.
      */
@@ -483,7 +543,7 @@ export interface Message {
     /**
      * The content of the message.
      */
-    content?: Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent> | null;
+    content?: Array<TextContent | ImageContent | ToolCallContent | ToolReturnContent | ReasoningContent | RedactedReasoningContent | OmittedReasoningContent | Message.SummarizedReasoningContent> | null;
     /**
      * The timestamp when the object was created.
      */
@@ -521,6 +581,10 @@ export interface Message {
      * 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
      */
@@ -540,13 +604,86 @@ export interface Message {
     /**
      * Tool execution return information for prior tool calls
      */
-    tool_returns?: Array<ToolReturn> | null;
+    tool_returns?: Array<Message.ToolReturn> | null;
     /**
      * The timestamp when the object was last updated.
      */
     updated_at?: string | null;
 }
 export declare namespace Message {
+    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';
+    }
+    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;
@@ -560,15 +697,48 @@ export declare namespace Message {
             [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;
+    }
 }
 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 +786,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 +800,37 @@ 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.
+ * 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 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.
+ * 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.
+     */
+    agent_id: string;
     /**
      * The human-friendly ID of the Run
      */
     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 +844,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 +866,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 +881,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 {
     /**
@@ -762,6 +939,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 +969,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 +994,9 @@ export interface ToolCallDelta {
 export interface ToolCallMessage {
     id: string;
     date: string;
+    /**
+     * @deprecated
+     */
     tool_call: ToolCall | ToolCallDelta;
     is_err?: boolean | null;
     /**
@@ -821,20 +1009,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 {
     /**
@@ -925,43 +1111,12 @@ 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 {
-    /**
-     * Result from a message search operation with scoring details.
-     */
-    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 MessageStreamResponse = unknown;
 export type MessageUpdateParams = MessageUpdateParams.UpdateSystemMessage | MessageUpdateParams.UpdateUserMessage | MessageUpdateParams.UpdateReasoningMessage | MessageUpdateParams.UpdateAssistantMessage;
 export declare namespace MessageUpdateParams {
     interface UpdateSystemMessage {
         /**
-         * Path param:
+         * Path param: The ID of the agent in the format 'agent-<uuid4>'
          */
         agent_id: string;
         /**
@@ -976,7 +1131,7 @@ export declare namespace MessageUpdateParams {
     }
     interface UpdateUserMessage {
         /**
-         * Path param:
+         * Path param: The ID of the agent in the format 'agent-<uuid4>'
          */
         agent_id: string;
         /**
@@ -991,7 +1146,7 @@ export declare namespace MessageUpdateParams {
     }
     interface UpdateReasoningMessage {
         /**
-         * Path param:
+         * Path param: The ID of the agent in the format 'agent-<uuid4>'
          */
         agent_id: string;
         /**
@@ -1005,7 +1160,7 @@ export declare namespace MessageUpdateParams {
     }
     interface UpdateAssistantMessage {
         /**
-         * Path param:
+         * Path param: The ID of the agent in the format 'agent-<uuid4>'
          */
         agent_id: string;
         /**
@@ -1021,19 +1176,21 @@ export declare namespace MessageUpdateParams {
 }
 export interface MessageListParams {
     /**
-     * Message after which to retrieve the returned messages.
+     * Message ID cursor for pagination. Returns messages that come after this message
+     * ID in the specified sort order
      */
     after?: string | null;
     /**
-     * The name of the message argument.
+     * @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;
     /**
-     * Message before which to retrieve the returned messages.
+     * Message ID cursor for pagination. Returns messages that come before this message
+     * ID in the specified sort order
      */
     before?: string | null;
     /**
@@ -1046,11 +1203,20 @@ export interface MessageListParams {
      */
     include_err?: boolean | null;
     /**
-     * Maximum number of messages to retrieve.
+     * Maximum number of messages to return
+     */
+    limit?: number | null;
+    /**
+     * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
+     * newest first
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Field to sort by
      */
-    limit?: number;
+    order_by?: 'created_at';
     /**
-     * Whether to use assistant messages
+     * @deprecated Whether to use assistant messages
      */
     use_assistant_message?: boolean;
 }
@@ -1060,120 +1226,11 @@ export interface MessageCancelParams {
      */
     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;
-        /**
-         * 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;
-        /**
-         * Whether the server should parse specific tool call arguments (default
-         * `send_message`) as `AssistantMessage` objects.
-         */
-        use_assistant_message?: boolean;
-    }
-    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;
-    }
-}
-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 MessageResetParams {
     /**
-     * Filter messages by template ID
+     * If true, adds the default initial messages after resetting.
      */
-    template_id?: string | null;
+    add_default_initial_messages?: boolean;
 }
 export interface MessageSendParams {
     /**
@@ -1181,15 +1238,19 @@ export interface MessageSendParams {
      */
     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;
     /**
@@ -1202,8 +1263,9 @@ export interface MessageSendParams {
      */
     max_steps?: number;
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * @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;
 }
@@ -1213,11 +1275,14 @@ export interface MessageSendAsyncParams {
      */
     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;
     /**
@@ -1225,7 +1290,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;
     /**
@@ -1238,22 +1304,26 @@ export interface MessageSendAsyncParams {
      */
     max_steps?: number;
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * @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 interface MessageStreamParams {
     /**
      * 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;
     /**
@@ -1261,7 +1331,8 @@ export interface MessageSendStreamParams {
      */
     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;
     /**
@@ -1284,12 +1355,13 @@ export interface MessageSendStreamParams {
      */
     stream_tokens?: boolean;
     /**
-     * Whether the server should parse specific tool call arguments (default
-     * `send_message`) as `AssistantMessage` objects.
+     * @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 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 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, };
 }
 //# sourceMappingURL=messages.d.mts.map