@letta-ai/letta-client 1.0.0-alpha.13 → 1.0.0-alpha.15

package/src/resources/agents/messages.ts

@@ -330,6 +330,36 @@ export interface AssistantMessage {
   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.
@@ -487,14 +517,11 @@ export type LettaMessageUnion =
   | ToolsAPI.ToolReturnMessage
   | AssistantMessage
   | ApprovalRequestMessage
-  | ApprovalResponseMessage;
+  | ApprovalResponseMessage
+  | SummaryMessage
+  | EventMessage;
 
 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
@@ -520,11 +547,34 @@ export interface LettaRequest {
    */
   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
@@ -533,6 +583,47 @@ export interface LettaRequest {
   use_assistant_message?: boolean;
 }
 
+export namespace LettaRequest {
+  /**
+   * 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;
+    }
+  }
+}
+
 /**
  * Response object from an agent interaction, consisting of the new messages
  * generated by the agent and usage statistics. The type of the returned messages
@@ -609,11 +700,6 @@ export namespace LettaResponse {
 }
 
 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
@@ -650,11 +736,34 @@ export interface LettaStreamingRequest {
    */
   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.
@@ -669,6 +778,47 @@ export interface LettaStreamingRequest {
   use_assistant_message?: boolean;
 }
 
+export namespace LettaStreamingRequest {
+  /**
+   * 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;
+    }
+  }
+}
+
 /**
  * Streaming response type for Server-Sent Events (SSE) endpoints. Each event in
  * the stream will be one of these types.
@@ -1283,6 +1433,34 @@ export namespace Run {
   }
 }
 
+/**
+ * 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.
@@ -1557,7 +1735,9 @@ export type MessageModifyResponse =
   | ToolsAPI.ToolReturnMessage
   | AssistantMessage
   | ApprovalRequestMessage
-  | ApprovalResponseMessage;
+  | ApprovalResponseMessage
+  | SummaryMessage
+  | EventMessage;
 
 export interface MessageListParams extends ArrayPageParams {
   /**
@@ -1681,11 +1861,6 @@ export interface MessageResetParams {
 }
 
 export interface MessageSendParams {
-  /**
-   * 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
@@ -1711,11 +1886,34 @@ export interface MessageSendParams {
    */
   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
+        | MessageSendParams.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
@@ -1724,12 +1922,48 @@ export interface MessageSendParams {
   use_assistant_message?: boolean;
 }
 
-export interface MessageSendAsyncParams {
+export namespace MessageSendParams {
   /**
-   * The messages to be sent to the agent.
+   * The style of reasoning content returned by the OpenAI Responses API
    */
-  messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
+  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 MessageSendAsyncParams {
   /**
    * @deprecated The name of the message argument in the designated message tool.
    * Still supported for legacy agent types, but deprecated for letta_v1_agent
@@ -1760,11 +1994,34 @@ export interface MessageSendAsyncParams {
    */
   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
+        | MessageSendAsyncParams.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
@@ -1773,12 +2030,48 @@ export interface MessageSendAsyncParams {
   use_assistant_message?: boolean;
 }
 
-export interface MessageStreamParams {
+export namespace MessageSendAsyncParams {
   /**
-   * The messages to be sent to the agent.
+   * The style of reasoning content returned by the OpenAI Responses API
    */
-  messages: Array<AgentsAPI.MessageCreate | ApprovalCreate>;
+  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 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
@@ -1815,11 +2108,34 @@ export interface MessageStreamParams {
    */
   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.
@@ -1834,12 +2150,54 @@ export interface MessageStreamParams {
   use_assistant_message?: boolean;
 }
 
+export namespace MessageStreamParams {
+  /**
+   * 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 declare namespace Messages {
   export {
     type ApprovalCreate as ApprovalCreate,
     type ApprovalRequestMessage as ApprovalRequestMessage,
     type ApprovalResponseMessage as ApprovalResponseMessage,
     type AssistantMessage as AssistantMessage,
+    type EventMessage as EventMessage,
     type HiddenReasoningMessage as HiddenReasoningMessage,
     type ImageContent as ImageContent,
     type JobStatus as JobStatus,
@@ -1859,6 +2217,7 @@ export declare namespace Messages {
     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,

package/src/resources/batches/batches.ts

@@ -165,11 +165,6 @@ export namespace BatchCreateParams {
      */
     agent_id: string;
 
-    /**
-     * The messages to be sent to the agent.
-     */
-    messages: Array<AgentsAPI.MessageCreate | MessagesAPI.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
@@ -195,11 +190,34 @@ export namespace BatchCreateParams {
      */
     include_return_message_types?: Array<MessagesAPI.MessageType> | null;
 
+    /**
+     * Syntactic sugar for a single user message. Equivalent to messages=[{'role':
+     * 'user', 'content': input}].
+     */
+    input?:
+      | string
+      | Array<
+          | MessagesAPI.TextContent
+          | MessagesAPI.ImageContent
+          | MessagesAPI.ToolCallContent
+          | MessagesAPI.ToolReturnContent
+          | MessagesAPI.ReasoningContent
+          | MessagesAPI.RedactedReasoningContent
+          | MessagesAPI.OmittedReasoningContent
+          | Request.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 | MessagesAPI.ApprovalCreate> | null;
+
     /**
      * @deprecated Whether the server should parse specific tool call arguments
      * (default `send_message`) as `AssistantMessage` objects. Still supported for
@@ -207,6 +225,47 @@ export namespace BatchCreateParams {
      */
     use_assistant_message?: boolean;
   }
+
+  export namespace Request {
+    /**
+     * 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 BatchListParams {