@letta-ai/letta-client 1.3.3 → 1.5.0

package/src/resources/agents/agents.ts

@@ -75,6 +75,7 @@ import {
   Message,
   MessageCancelParams,
   MessageCancelResponse,
+  MessageCompactParams,
   MessageCreateAsyncParams,
   MessageCreateParams,
   MessageCreateParamsNonStreaming,
@@ -359,6 +360,15 @@ export interface AgentState {
    */
   base_template_id?: string | null;
 
+  /**
+   * Configuration for conversation compaction / summarization.
+   *
+   * `model` is the only required user-facing field – it specifies the summarizer
+   * model handle (e.g. `"openai/gpt-4o-mini"`). Per-model settings (temperature, max
+   * tokens, etc.) are derived from the default configuration for that handle.
+   */
+  compaction_settings?: AgentState.CompactionSettings | null;
+
   /**
    * The timestamp when the object was created.
    */
@@ -745,6 +755,64 @@ export namespace AgentState {
      */
     vector_db_provider?: ArchivesArchivesAPI.VectorDBProvider;
   }
+
+  /**
+   * Configuration for conversation compaction / summarization.
+   *
+   * `model` is the only required user-facing field – it specifies the summarizer
+   * model handle (e.g. `"openai/gpt-4o-mini"`). Per-model settings (temperature, max
+   * tokens, etc.) are derived from the default configuration for that handle.
+   */
+  export interface CompactionSettings {
+    /**
+     * Model handle to use for summarization (format: provider/model-name).
+     */
+    model: string;
+
+    /**
+     * The maximum length of the summary in characters. If none, no clipping is
+     * performed.
+     */
+    clip_chars?: number | null;
+
+    /**
+     * The type of summarization technique use.
+     */
+    mode?: 'all' | 'sliding_window';
+
+    /**
+     * Optional model settings used to override defaults for the summarizer model.
+     */
+    model_settings?:
+      | AgentsAPI.OpenAIModelSettings
+      | AgentsAPI.AnthropicModelSettings
+      | AgentsAPI.GoogleAIModelSettings
+      | AgentsAPI.GoogleVertexModelSettings
+      | AgentsAPI.AzureModelSettings
+      | AgentsAPI.XaiModelSettings
+      | AgentsAPI.GroqModelSettings
+      | AgentsAPI.DeepseekModelSettings
+      | AgentsAPI.TogetherModelSettings
+      | AgentsAPI.BedrockModelSettings
+      | null;
+
+    /**
+     * The prompt to use for summarization.
+     */
+    prompt?: string;
+
+    /**
+     * Whether to include an acknowledgement post-prompt (helps prevent non-summary
+     * outputs).
+     */
+    prompt_acknowledgement?: boolean;
+
+    /**
+     * The percentage of the context window to keep post-summarization (only used in
+     * sliding window mode).
+     */
+    sliding_window_percentage?: number;
+  }
 }
 
 /**
@@ -1312,7 +1380,7 @@ export namespace OpenAIModelSettings {
     /**
      * The reasoning effort to use when generating text reasoning models
      */
-    reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high';
+    reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
   }
 }
 
@@ -1494,6 +1562,15 @@ export interface AgentCreateParams {
    */
   block_ids?: Array<string> | null;
 
+  /**
+   * Configuration for conversation compaction / summarization.
+   *
+   * `model` is the only required user-facing field – it specifies the summarizer
+   * model handle (e.g. `"openai/gpt-4o-mini"`). Per-model settings (temperature, max
+   * tokens, etc.) are derived from the default configuration for that handle.
+   */
+  compaction_settings?: AgentCreateParams.CompactionSettings | null;
+
   /**
    * The context window limit used by the agent.
    */
@@ -1764,6 +1841,66 @@ export interface AgentCreateParams {
   tools?: Array<string> | null;
 }
 
+export namespace AgentCreateParams {
+  /**
+   * Configuration for conversation compaction / summarization.
+   *
+   * `model` is the only required user-facing field – it specifies the summarizer
+   * model handle (e.g. `"openai/gpt-4o-mini"`). Per-model settings (temperature, max
+   * tokens, etc.) are derived from the default configuration for that handle.
+   */
+  export interface CompactionSettings {
+    /**
+     * Model handle to use for summarization (format: provider/model-name).
+     */
+    model: string;
+
+    /**
+     * The maximum length of the summary in characters. If none, no clipping is
+     * performed.
+     */
+    clip_chars?: number | null;
+
+    /**
+     * The type of summarization technique use.
+     */
+    mode?: 'all' | 'sliding_window';
+
+    /**
+     * Optional model settings used to override defaults for the summarizer model.
+     */
+    model_settings?:
+      | AgentsAPI.OpenAIModelSettings
+      | AgentsAPI.AnthropicModelSettings
+      | AgentsAPI.GoogleAIModelSettings
+      | AgentsAPI.GoogleVertexModelSettings
+      | AgentsAPI.AzureModelSettings
+      | AgentsAPI.XaiModelSettings
+      | AgentsAPI.GroqModelSettings
+      | AgentsAPI.DeepseekModelSettings
+      | AgentsAPI.TogetherModelSettings
+      | AgentsAPI.BedrockModelSettings
+      | null;
+
+    /**
+     * The prompt to use for summarization.
+     */
+    prompt?: string;
+
+    /**
+     * Whether to include an acknowledgement post-prompt (helps prevent non-summary
+     * outputs).
+     */
+    prompt_acknowledgement?: boolean;
+
+    /**
+     * The percentage of the context window to keep post-summarization (only used in
+     * sliding window mode).
+     */
+    sliding_window_percentage?: number;
+  }
+}
+
 export interface AgentRetrieveParams {
   /**
    * Specify which relational fields to include in the response. No relationships are
@@ -1799,6 +1936,15 @@ export interface AgentUpdateParams {
    */
   block_ids?: Array<string> | null;
 
+  /**
+   * Configuration for conversation compaction / summarization.
+   *
+   * `model` is the only required user-facing field – it specifies the summarizer
+   * model handle (e.g. `"openai/gpt-4o-mini"`). Per-model settings (temperature, max
+   * tokens, etc.) are derived from the default configuration for that handle.
+   */
+  compaction_settings?: AgentUpdateParams.CompactionSettings | null;
+
   /**
    * The context window limit used by the agent.
    */
@@ -2005,6 +2151,66 @@ export interface AgentUpdateParams {
   > | null;
 }
 
+export namespace AgentUpdateParams {
+  /**
+   * Configuration for conversation compaction / summarization.
+   *
+   * `model` is the only required user-facing field – it specifies the summarizer
+   * model handle (e.g. `"openai/gpt-4o-mini"`). Per-model settings (temperature, max
+   * tokens, etc.) are derived from the default configuration for that handle.
+   */
+  export interface CompactionSettings {
+    /**
+     * Model handle to use for summarization (format: provider/model-name).
+     */
+    model: string;
+
+    /**
+     * The maximum length of the summary in characters. If none, no clipping is
+     * performed.
+     */
+    clip_chars?: number | null;
+
+    /**
+     * The type of summarization technique use.
+     */
+    mode?: 'all' | 'sliding_window';
+
+    /**
+     * Optional model settings used to override defaults for the summarizer model.
+     */
+    model_settings?:
+      | AgentsAPI.OpenAIModelSettings
+      | AgentsAPI.AnthropicModelSettings
+      | AgentsAPI.GoogleAIModelSettings
+      | AgentsAPI.GoogleVertexModelSettings
+      | AgentsAPI.AzureModelSettings
+      | AgentsAPI.XaiModelSettings
+      | AgentsAPI.GroqModelSettings
+      | AgentsAPI.DeepseekModelSettings
+      | AgentsAPI.TogetherModelSettings
+      | AgentsAPI.BedrockModelSettings
+      | null;
+
+    /**
+     * The prompt to use for summarization.
+     */
+    prompt?: string;
+
+    /**
+     * Whether to include an acknowledgement post-prompt (helps prevent non-summary
+     * outputs).
+     */
+    prompt_acknowledgement?: boolean;
+
+    /**
+     * The percentage of the context window to keep post-summarization (only used in
+     * sliding window mode).
+     */
+    sliding_window_percentage?: number;
+  }
+}
+
 export interface AgentListParams extends ArrayPageParams {
   /**
    * @deprecated Whether to sort agents oldest to newest (True) or newest to oldest
@@ -2274,6 +2480,7 @@ export declare namespace Agents {
     type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
     type MessageListParams as MessageListParams,
     type MessageCancelParams as MessageCancelParams,
+    type MessageCompactParams as MessageCompactParams,
     type MessageCreateAsyncParams as MessageCreateAsyncParams,
     type MessageResetParams as MessageResetParams,
     type MessageStreamParams as MessageStreamParams,

package/src/resources/agents/index.ts

@@ -131,6 +131,7 @@ export {
   type MessageCreateParamsStreaming,
   type MessageListParams,
   type MessageCancelParams,
+  type MessageCompactParams,
   type MessageCreateAsyncParams,
   type MessageResetParams,
   type MessageStreamParams,

package/src/resources/agents/messages.ts

@@ -87,8 +87,13 @@ export class Messages extends APIResource {
   /**
    * Summarize an agent's conversation history.
    */
-  compact(agentID: string, options?: RequestOptions): APIPromise<void> {
+  compact(
+    agentID: string,
+    body: MessageCompactParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<void> {
     return this._client.post(path`/v1/agents/${agentID}/summarize`, {
+      body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -704,9 +709,15 @@ export namespace InternalMessage {
     }
   }
 
+  /**
+   * A call to a function tool created by the model.
+   */
   export interface ToolCall {
     id: string;
 
+    /**
+     * The function that the model called.
+     */
     function: ToolCall.Function;
 
     type: 'function';
@@ -715,6 +726,9 @@ export namespace InternalMessage {
   }
 
   export namespace ToolCall {
+    /**
+     * The function that the model called.
+     */
     export interface Function {
       arguments: string;
 
@@ -1952,6 +1966,77 @@ export interface MessageCancelParams {
   run_ids?: Array<string> | null;
 }
 
+export interface MessageCompactParams {
+  /**
+   * Configuration for conversation compaction / summarization.
+   *
+   * `model` is the only required user-facing field – it specifies the summarizer
+   * model handle (e.g. `"openai/gpt-4o-mini"`). Per-model settings (temperature, max
+   * tokens, etc.) are derived from the default configuration for that handle.
+   */
+  compaction_settings?: MessageCompactParams.CompactionSettings | null;
+}
+
+export namespace MessageCompactParams {
+  /**
+   * Configuration for conversation compaction / summarization.
+   *
+   * `model` is the only required user-facing field – it specifies the summarizer
+   * model handle (e.g. `"openai/gpt-4o-mini"`). Per-model settings (temperature, max
+   * tokens, etc.) are derived from the default configuration for that handle.
+   */
+  export interface CompactionSettings {
+    /**
+     * Model handle to use for summarization (format: provider/model-name).
+     */
+    model: string;
+
+    /**
+     * The maximum length of the summary in characters. If none, no clipping is
+     * performed.
+     */
+    clip_chars?: number | null;
+
+    /**
+     * The type of summarization technique use.
+     */
+    mode?: 'all' | 'sliding_window';
+
+    /**
+     * Optional model settings used to override defaults for the summarizer model.
+     */
+    model_settings?:
+      | AgentsAPI.OpenAIModelSettings
+      | AgentsAPI.AnthropicModelSettings
+      | AgentsAPI.GoogleAIModelSettings
+      | AgentsAPI.GoogleVertexModelSettings
+      | AgentsAPI.AzureModelSettings
+      | AgentsAPI.XaiModelSettings
+      | AgentsAPI.GroqModelSettings
+      | AgentsAPI.DeepseekModelSettings
+      | AgentsAPI.TogetherModelSettings
+      | AgentsAPI.BedrockModelSettings
+      | null;
+
+    /**
+     * The prompt to use for summarization.
+     */
+    prompt?: string;
+
+    /**
+     * Whether to include an acknowledgement post-prompt (helps prevent non-summary
+     * outputs).
+     */
+    prompt_acknowledgement?: boolean;
+
+    /**
+     * The percentage of the context window to keep post-summarization (only used in
+     * sliding window mode).
+     */
+    sliding_window_percentage?: number;
+  }
+}
+
 export interface MessageCreateAsyncParams {
   /**
    * @deprecated The name of the message argument in the designated message tool.
@@ -2242,6 +2327,7 @@ export declare namespace Messages {
     type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
     type MessageListParams as MessageListParams,
     type MessageCancelParams as MessageCancelParams,
+    type MessageCompactParams as MessageCompactParams,
     type MessageCreateAsyncParams as MessageCreateAsyncParams,
     type MessageResetParams as MessageResetParams,
     type MessageStreamParams as MessageStreamParams,

package/src/resources/messages.ts

@@ -1,7 +1,6 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
-import * as ToolsAPI from './tools';
 import * as AgentsMessagesAPI from './agents/messages';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
@@ -88,19 +87,134 @@ export interface MessageSearchResult {
 export type MessageListResponse = Array<AgentsMessagesAPI.Message>;
 
 export type MessageSearchResponse = Array<
-  | AgentsMessagesAPI.SystemMessage
-  | AgentsMessagesAPI.UserMessage
-  | AgentsMessagesAPI.ReasoningMessage
-  | AgentsMessagesAPI.HiddenReasoningMessage
-  | AgentsMessagesAPI.ToolCallMessage
-  | ToolsAPI.ToolReturnMessage
-  | AgentsMessagesAPI.AssistantMessage
-  | AgentsMessagesAPI.ApprovalRequestMessage
-  | AgentsMessagesAPI.ApprovalResponseMessage
-  | AgentsMessagesAPI.SummaryMessage
-  | AgentsMessagesAPI.EventMessage
+  | MessageSearchResponse.SystemMessageListResult
+  | MessageSearchResponse.UserMessageListResult
+  | MessageSearchResponse.ReasoningMessageListResult
+  | MessageSearchResponse.AssistantMessageListResult
 >;
 
+export namespace MessageSearchResponse {
+  /**
+   * System message list result with agent context.
+   *
+   * Shape is identical to UpdateSystemMessage but includes the owning agent_id and
+   * message id.
+   */
+  export interface SystemMessageListResult {
+    /**
+     * The message content sent by the system (can be a string or an array of
+     * multi-modal content parts)
+     */
+    content: string;
+
+    /**
+     * The time the message was created in ISO format.
+     */
+    created_at: string;
+
+    /**
+     * The unique identifier of the message.
+     */
+    message_id: string;
+
+    /**
+     * The unique identifier of the agent that owns the message.
+     */
+    agent_id?: string | null;
+
+    message_type?: 'system_message';
+  }
+
+  /**
+   * User message list result with agent context.
+   *
+   * Shape is identical to UpdateUserMessage but includes the owning agent_id and
+   * message id.
+   */
+  export interface UserMessageListResult {
+    /**
+     * The message content sent by the user (can be a string or an array of multi-modal
+     * content parts)
+     */
+    content: Array<AgentsMessagesAPI.LettaUserMessageContentUnion> | string;
+
+    /**
+     * The time the message was created in ISO format.
+     */
+    created_at: string;
+
+    /**
+     * The unique identifier of the message.
+     */
+    message_id: string;
+
+    /**
+     * The unique identifier of the agent that owns the message.
+     */
+    agent_id?: string | null;
+
+    message_type?: 'user_message';
+  }
+
+  /**
+   * Reasoning message list result with agent context.
+   *
+   * Shape is identical to UpdateReasoningMessage but includes the owning agent_id
+   * and message id.
+   */
+  export interface ReasoningMessageListResult {
+    /**
+     * The time the message was created in ISO format.
+     */
+    created_at: string;
+
+    /**
+     * The unique identifier of the message.
+     */
+    message_id: string;
+
+    reasoning: string;
+
+    /**
+     * The unique identifier of the agent that owns the message.
+     */
+    agent_id?: string | null;
+
+    message_type?: 'reasoning_message';
+  }
+
+  /**
+   * Assistant message list result with agent context.
+   *
+   * Shape is identical to UpdateAssistantMessage but includes the owning agent_id
+   * and message id.
+   */
+  export interface AssistantMessageListResult {
+    /**
+     * The message content sent by the assistant (can be a string or an array of
+     * content parts)
+     */
+    content: Array<AgentsMessagesAPI.LettaAssistantMessageContentUnion> | string;
+
+    /**
+     * The time the message was created in ISO format.
+     */
+    created_at: string;
+
+    /**
+     * The unique identifier of the message.
+     */
+    message_id: string;
+
+    /**
+     * The unique identifier of the agent that owns the message.
+     */
+    agent_id?: string | null;
+
+    message_type?: 'assistant_message';
+  }
+}
+
 export interface MessageListParams {
   /**
    * Message ID cursor for pagination. Returns messages that come after this message

package/src/resources/models/models.ts

@@ -325,7 +325,7 @@ export interface LlmConfig {
   /**
    * The reasoning effort to use when generating text reasoning models
    */
-  reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | null;
+  reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
 
   /**
    * The response format for the model's output. Supports text, json_object, and
@@ -490,7 +490,7 @@ export interface Model {
    * @deprecated Deprecated: The reasoning effort to use when generating text
    * reasoning models.
    */
-  reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | null;
+  reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | null;
 
   /**
    * The response format for the model's output. Supports text, json_object, and

package/src/resources/runs/runs.ts

@@ -140,10 +140,12 @@ export type StopReasonType =
   | 'invalid_llm_response'
   | 'invalid_tool_call'
   | 'max_steps'
+  | 'max_tokens_exceeded'
   | 'no_tool_call'
   | 'tool_rule'
   | 'cancelled'
-  | 'requires_approval';
+  | 'requires_approval'
+  | 'context_window_overflow_in_system_prompt';
 
 export interface RunListParams extends ArrayPageParams {
   /**

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.3.3'; // x-release-please-version
+export const VERSION = '1.5.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.3.3";
+export declare const VERSION = "1.5.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.3.3";
+export declare const VERSION = "1.5.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.3.3'; // x-release-please-version
+exports.VERSION = '1.5.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.3.3'; // x-release-please-version
+export const VERSION = '1.5.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map