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

package/src/resources/agents/messages.ts

@@ -2,10 +2,11 @@
 
 import { APIResource } from '../../core/resource';
 import * as MessagesAPI from './messages';
-import * as RunsAPI from '../runs';
+import * as ToolsAPI from '../tools';
 import * as AgentsAPI from './agents';
-import * as ToolsAPI from '../tools/tools';
+import * as RunsAPI from '../runs/runs';
 import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -48,28 +49,14 @@ export class Messages extends APIResource {
   }
 
   /**
-   * 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.
+   * Resets the messages for an agent
    */
-  previewRawPayload(
+  reset(
     agentID: string,
-    body: MessagePreviewRawPayloadParams,
+    body: MessageResetParams,
     options?: RequestOptions,
-  ): APIPromise<MessagePreviewRawPayloadResponse> {
-    return this._client.post(path`/v1/agents/${agentID}/messages/preview-raw-payload`, { body, ...options });
-  }
-
-  /**
-   * Search messages across the entire organization with optional project and
-   * template filtering. Returns messages with FTS/vector ranks and total RRF score.
-   *
-   * This is a cloud-only feature.
-   */
-  search(body: MessageSearchParams, options?: RequestOptions): APIPromise<MessageSearchResponse> {
-    return this._client.post('/v1/agents/messages/search', { body, ...options });
+  ): APIPromise<AgentsAPI.AgentState> {
+    return this._client.patch(path`/v1/agents/${agentID}/reset-messages`, { body, ...options });
   }
 
   /**
@@ -85,8 +72,8 @@ export 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> {
     return this._client.post(path`/v1/agents/${agentID}/messages/async`, { body, ...options });
@@ -97,9 +84,19 @@ export 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> {
     return this._client.post(path`/v1/agents/${agentID}/messages/stream`, { body, ...options });
   }
+
+  /**
+   * Summarize an agent's conversation history.
+   */
+  summarize(agentID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/v1/agents/${agentID}/summarize`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
 }
 
 /**
@@ -107,17 +104,22 @@ export class Messages extends APIResource {
  */
 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;
+
+  /**
+   * @deprecated Whether the tool has been approved
+   */
+  approve?: boolean | null;
 
   /**
-   * An optional explanation for the provided approval status
+   * @deprecated An optional explanation for the provided approval status
    */
   reason?: string | null;
 
@@ -127,6 +129,30 @@ export interface ApprovalCreate {
   type?: 'approval';
 }
 
+export namespace ApprovalCreate {
+  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 representing a request for approval to call a tool (generated by the
  * LLM to trigger tool execution).
@@ -141,7 +167,7 @@ export interface ApprovalRequestMessage {
   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;
 
@@ -163,6 +189,12 @@ export interface ApprovalRequestMessage {
   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;
 }
 
 /**
@@ -178,17 +210,22 @@ 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;
+  approvals?: Array<ApprovalResponseMessage.ApprovalReturn | ToolReturn> | null;
 
-  date: string;
+  /**
+   * @deprecated Whether the tool has been approved
+   */
+  approve?: boolean | null;
 
   is_err?: boolean | null;
 
@@ -202,7 +239,7 @@ export interface ApprovalResponseMessage {
   otid?: string | null;
 
   /**
-   * An optional explanation for the provided approval status
+   * @deprecated An optional explanation for the provided approval status
    */
   reason?: string | null;
 
@@ -215,6 +252,30 @@ export interface ApprovalResponseMessage {
   step_id?: string | null;
 }
 
+export namespace ApprovalResponseMessage {
+  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.
  *
@@ -383,6 +444,11 @@ export interface LettaAssistantMessageContentUnion {
    */
   text: string;
 
+  /**
+   * Stores a unique identifier for any reasoning associated with this text content.
+   */
+  signature?: string | null;
+
   /**
    * The type of the message.
    */
@@ -415,17 +481,21 @@ 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;
 
@@ -441,8 +511,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;
 }
@@ -515,11 +586,6 @@ export namespace LettaResponse {
      */
     step_count?: number;
 
-    /**
-     * The messages generated per step
-     */
-    steps_messages?: Array<Array<MessagesAPI.Message>> | null;
-
     /**
      * The total number of tokens processed by the agent.
      */
@@ -534,12 +600,15 @@ 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;
 
@@ -549,7 +618,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;
 
@@ -577,8 +647,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;
 }
@@ -629,6 +700,11 @@ export interface Message {
    */
   approval_request_id?: string | null;
 
+  /**
+   * The list of approvals for this message.
+   */
+  approvals?: Array<Message.ApprovalReturn | Message.LettaSchemasMessageToolReturn> | null;
+
   /**
    * Whether tool call is approved.
    */
@@ -650,6 +726,7 @@ export interface Message {
     | ReasoningContent
     | RedactedReasoningContent
     | OmittedReasoningContent
+    | Message.SummarizedReasoningContent
   > | null;
 
   /**
@@ -698,6 +775,11 @@ export interface 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
    */
@@ -721,7 +803,7 @@ 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.
@@ -730,6 +812,94 @@ export interface Message {
 }
 
 export namespace Message {
+  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';
+  }
+
+  export 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
+   */
+  export 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';
+  }
+
+  export namespace SummarizedReasoningContent {
+    export interface Summary {
+      /**
+       * The index of the summary part.
+       */
+      index: number;
+
+      /**
+       * The text of the summary part.
+       */
+      text: string;
+    }
+  }
+
   export interface ToolCall {
     id: string;
 
@@ -749,6 +919,33 @@ export namespace Message {
       [k: string]: unknown;
     }
   }
+
+  export 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';
@@ -764,13 +961,25 @@ export type MessageType =
   | '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
@@ -835,6 +1044,9 @@ export interface ReasoningMessage {
   step_id?: string | null;
 }
 
+/**
+ * Sent via the Anthropic Messages API
+ */
 export interface RedactedReasoningContent {
   /**
    * The redacted or filtered intermediate reasoning content.
@@ -848,21 +1060,41 @@ export interface RedactedReasoningContent {
 }
 
 /**
- * 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.
    */
@@ -879,34 +1111,22 @@ 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 } | null;
 
@@ -916,9 +1136,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.
@@ -934,11 +1154,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 namespace Run {
@@ -1014,6 +1229,11 @@ export interface TextContent {
    */
   text: string;
 
+  /**
+   * Stores a unique identifier for any reasoning associated with this text content.
+   */
+  signature?: string | null;
+
   /**
    * The type of the message.
    */
@@ -1045,6 +1265,11 @@ export interface ToolCallContent {
    */
   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.
    */
@@ -1072,6 +1297,9 @@ export interface ToolCallMessage {
 
   date: string;
 
+  /**
+   * @deprecated
+   */
   tool_call: ToolCall | ToolCallDelta;
 
   is_err?: boolean | null;
@@ -1092,23 +1320,25 @@ export interface ToolCallMessage {
   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 {
@@ -1233,43 +1463,7 @@ export type MessageListResponse = Array<LettaMessageUnion>;
 
 export type MessageCancelResponse = { [key: string]: unknown };
 
-export type MessagePreviewRawPayloadResponse = { [key: string]: unknown };
-
-export type MessageSearchResponse = Array<MessageSearchResponse.MessageSearchResponseItem>;
-
-export namespace MessageSearchResponse {
-  /**
-   * Result from a message search operation with scoring details.
-   */
-  export 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
@@ -1280,7 +1474,7 @@ export type MessageUpdateParams =
 export declare namespace MessageUpdateParams {
   export interface UpdateSystemMessage {
     /**
-     * Path param:
+     * Path param: The ID of the agent in the format 'agent-<uuid4>'
      */
     agent_id: string;
 
@@ -1298,7 +1492,7 @@ export declare namespace MessageUpdateParams {
 
   export interface UpdateUserMessage {
     /**
-     * Path param:
+     * Path param: The ID of the agent in the format 'agent-<uuid4>'
      */
     agent_id: string;
 
@@ -1316,7 +1510,7 @@ export declare namespace MessageUpdateParams {
 
   export interface UpdateReasoningMessage {
     /**
-     * Path param:
+     * Path param: The ID of the agent in the format 'agent-<uuid4>'
      */
     agent_id: string;
 
@@ -1333,7 +1527,7 @@ export declare namespace MessageUpdateParams {
 
   export interface UpdateAssistantMessage {
     /**
-     * Path param:
+     * Path param: The ID of the agent in the format 'agent-<uuid4>'
      */
     agent_id: string;
 
@@ -1352,22 +1546,24 @@ 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;
 
@@ -1383,164 +1579,39 @@ export interface MessageListParams {
   include_err?: boolean | null;
 
   /**
-   * Maximum number of messages to retrieve.
+   * Maximum number of messages to return
    */
-  limit?: number;
+  limit?: number | null;
 
   /**
-   * Whether to use assistant messages
+   * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
+   * newest first
    */
-  use_assistant_message?: boolean;
-}
+  order?: 'asc' | 'desc';
 
-export interface MessageCancelParams {
   /**
-   * Optional list of run IDs to cancel
+   * Field to sort by
    */
-  run_ids?: Array<string> | null;
-}
-
-export type MessagePreviewRawPayloadParams =
-  | MessagePreviewRawPayloadParams.LettaRequest
-  | MessagePreviewRawPayloadParams.LettaStreamingRequest;
-
-export declare namespace MessagePreviewRawPayloadParams {
-  export interface LettaRequest {
-    /**
-     * The messages to be sent to the agent.
-     */
-    messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
-
-    /**
-     * The name of the message argument in the designated message tool.
-     */
-    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;
-  }
-
-  export interface LettaStreamingRequest {
-    /**
-     * The messages to be sent to the agent.
-     */
-    messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
-
-    /**
-     * The name of the message argument in the designated message tool.
-     */
-    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;
+  order_by?: 'created_at';
 
   /**
-   * Filter messages by role
+   * @deprecated Whether to use assistant messages
    */
-  roles?: Array<MessageRole> | null;
-
-  /**
-   * Search mode to use
-   */
-  search_mode?: 'vector' | 'fts' | 'hybrid';
+  use_assistant_message?: boolean;
+}
 
+export interface MessageCancelParams {
   /**
-   * Filter messages created after this date
+   * Optional list of run IDs to cancel
    */
-  start_date?: string | null;
+  run_ids?: Array<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 {
@@ -1550,17 +1621,21 @@ 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;
 
@@ -1576,8 +1651,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;
 }
@@ -1589,12 +1665,15 @@ 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;
 
@@ -1604,7 +1683,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;
 
@@ -1620,25 +1700,29 @@ 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;
 
@@ -1648,7 +1732,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;
 
@@ -1676,8 +1761,9 @@ 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;
 }
@@ -1722,16 +1808,13 @@ export declare namespace Messages {
     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 MessageStreamResponse as MessageStreamResponse,
     type MessageUpdateParams as MessageUpdateParams,
     type MessageListParams as MessageListParams,
     type MessageCancelParams as MessageCancelParams,
-    type MessagePreviewRawPayloadParams as MessagePreviewRawPayloadParams,
-    type MessageSearchParams as MessageSearchParams,
+    type MessageResetParams as MessageResetParams,
     type MessageSendParams as MessageSendParams,
     type MessageSendAsyncParams as MessageSendAsyncParams,
-    type MessageSendStreamParams as MessageSendStreamParams,
+    type MessageStreamParams as MessageStreamParams,
   };
 }