@letta-ai/letta-client 1.4.0 → 1.6.0

package/src/resources/agents/index.ts

@@ -126,11 +126,13 @@ export {
   type UpdateUserMessage,
   type UserMessage,
   type MessageCancelResponse,
+  type MessageCompactResponse,
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,
   type MessageCreateParamsStreaming,
   type MessageListParams,
   type MessageCancelParams,
+  type MessageCompactParams,
   type MessageCreateAsyncParams,
   type MessageResetParams,
   type MessageStreamParams,

package/src/resources/agents/messages.ts

@@ -8,7 +8,6 @@ import * as RunsAPI from '../runs/runs';
 import { APIPromise } from '../../core/api-promise';
 import { ArrayPage, type ArrayPageParams, ObjectPage, PagePromise } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
-import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -87,11 +86,12 @@ export class Messages extends APIResource {
   /**
    * Summarize an agent's conversation history.
    */
-  compact(agentID: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/v1/agents/${agentID}/summarize`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
+  compact(
+    agentID: string,
+    body: MessageCompactParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageCompactResponse> {
+    return this._client.post(path`/v1/agents/${agentID}/summarize`, { body, ...options });
   }
 
   /**
@@ -1778,6 +1778,14 @@ export interface UserMessage {
 
 export type MessageCancelResponse = { [key: string]: unknown };
 
+export interface MessageCompactResponse {
+  num_messages_after: number;
+
+  num_messages_before: number;
+
+  summary_message: string;
+}
+
 export type MessageCreateParams = MessageCreateParamsNonStreaming | MessageCreateParamsStreaming;
 
 export interface MessageCreateParamsBase {
@@ -1961,6 +1969,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.
@@ -2245,12 +2324,14 @@ export declare namespace Messages {
     type UpdateUserMessage as UpdateUserMessage,
     type UserMessage as UserMessage,
     type MessageCancelResponse as MessageCancelResponse,
+    type MessageCompactResponse as MessageCompactResponse,
     type MessagesArrayPage as MessagesArrayPage,
     type MessageCreateParams as MessageCreateParams,
     type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
     type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
     type MessageListParams as MessageListParams,
     type MessageCancelParams as MessageCancelParams,
+    type MessageCompactParams as MessageCompactParams,
     type MessageCreateAsyncParams as MessageCreateAsyncParams,
     type MessageResetParams as MessageResetParams,
     type MessageStreamParams as MessageStreamParams,

package/src/resources/messages.ts

@@ -97,7 +97,8 @@ export namespace MessageSearchResponse {
   /**
    * System message list result with agent context.
    *
-   * Shape is identical to UpdateSystemMessage but includes the owning agent_id.
+   * Shape is identical to UpdateSystemMessage but includes the owning agent_id and
+   * message id.
    */
   export interface SystemMessageListResult {
     /**
@@ -111,6 +112,11 @@ export namespace MessageSearchResponse {
      */
     created_at: string;
 
+    /**
+     * The unique identifier of the message.
+     */
+    message_id: string;
+
     /**
      * The unique identifier of the agent that owns the message.
      */
@@ -122,7 +128,8 @@ export namespace MessageSearchResponse {
   /**
    * User message list result with agent context.
    *
-   * Shape is identical to UpdateUserMessage but includes the owning agent_id.
+   * Shape is identical to UpdateUserMessage but includes the owning agent_id and
+   * message id.
    */
   export interface UserMessageListResult {
     /**
@@ -136,6 +143,11 @@ export namespace MessageSearchResponse {
      */
     created_at: string;
 
+    /**
+     * The unique identifier of the message.
+     */
+    message_id: string;
+
     /**
      * The unique identifier of the agent that owns the message.
      */
@@ -147,7 +159,8 @@ export namespace MessageSearchResponse {
   /**
    * Reasoning message list result with agent context.
    *
-   * Shape is identical to UpdateReasoningMessage but includes the owning agent_id.
+   * Shape is identical to UpdateReasoningMessage but includes the owning agent_id
+   * and message id.
    */
   export interface ReasoningMessageListResult {
     /**
@@ -155,6 +168,11 @@ export namespace MessageSearchResponse {
      */
     created_at: string;
 
+    /**
+     * The unique identifier of the message.
+     */
+    message_id: string;
+
     reasoning: string;
 
     /**
@@ -168,7 +186,8 @@ export namespace MessageSearchResponse {
   /**
    * Assistant message list result with agent context.
    *
-   * Shape is identical to UpdateAssistantMessage but includes the owning agent_id.
+   * Shape is identical to UpdateAssistantMessage but includes the owning agent_id
+   * and message id.
    */
   export interface AssistantMessageListResult {
     /**
@@ -182,6 +201,11 @@ export namespace MessageSearchResponse {
      */
     created_at: string;
 
+    /**
+     * The unique identifier of the message.
+     */
+    message_id: string;
+
     /**
      * The unique identifier of the agent that owns the message.
      */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.4.0'; // x-release-please-version
+export const VERSION = '1.6.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.4.0";
+export declare const VERSION = "1.6.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.4.0'; // x-release-please-version
+exports.VERSION = '1.6.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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