@letta-ai/letta-client 1.7.8 → 1.7.9

package/resources/conversations/conversations.d.mts

@@ -1,4 +1,5 @@
 import { APIResource } from "../../core/resource.mjs";
+import * as AgentsAPI from "../agents/agents.mjs";
 import * as MessagesAPI from "./messages.mjs";
 import { CompactionRequest, CompactionResponse, MessageCompactParams, MessageCreateParams, MessageListParams, MessageStreamParams, MessageStreamResponse, Messages } from "./messages.mjs";
 import { APIPromise } from "../../core/api-promise.mjs";
@@ -18,9 +19,18 @@ export declare class Conversations extends APIResource {
      */
     update(conversationID: string, body: ConversationUpdateParams, options?: RequestOptions): APIPromise<Conversation>;
     /**
-     * List all conversations for an agent.
+     * List all conversations for an agent (or all conversations if agent_id not
+     * provided).
      */
-    list(query: ConversationListParams, options?: RequestOptions): APIPromise<ConversationListResponse>;
+    list(query?: ConversationListParams | null | undefined, options?: RequestOptions): APIPromise<ConversationListResponse>;
+    /**
+     * Delete a conversation (soft delete).
+     *
+     * This marks the conversation as deleted but does not permanently remove it from
+     * the database. The conversation will no longer appear in list operations. Any
+     * isolated blocks associated with the conversation will be permanently deleted.
+     */
+    delete(conversationID: string, options?: RequestOptions): APIPromise<unknown>;
     /**
      * Cancel runs associated with a conversation.
      *
@@ -61,6 +71,15 @@ export interface Conversation {
      * The id of the user that made this object.
      */
     last_updated_by_id?: string | null;
+    /**
+     * The model handle for this conversation (overrides agent's model). Format:
+     * provider/model-name.
+     */
+    model?: string | null;
+    /**
+     * The model settings for this conversation (overrides agent's model settings).
+     */
+    model_settings?: AgentsAPI.OpenAIModelSettings | AgentsAPI.AnthropicModelSettings | AgentsAPI.GoogleAIModelSettings | AgentsAPI.GoogleVertexModelSettings | AgentsAPI.AzureModelSettings | AgentsAPI.XaiModelSettings | Conversation.ZaiModelSettings | AgentsAPI.GroqModelSettings | AgentsAPI.DeepseekModelSettings | AgentsAPI.TogetherModelSettings | AgentsAPI.BedrockModelSettings | Conversation.OpenRouterModelSettings | Conversation.ChatGptoAuthModelSettings | null;
     /**
      * A summary of the conversation.
      */
@@ -70,6 +89,113 @@ export interface Conversation {
      */
     updated_at?: string | null;
 }
+export declare namespace Conversation {
+    /**
+     * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
+     */
+    interface ZaiModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'zai';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        thinking?: ZaiModelSettings.Thinking;
+    }
+    namespace ZaiModelSettings {
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        interface Thinking {
+            /**
+             * If False, preserved thinking is used (recommended for agents).
+             */
+            clear_thinking?: boolean;
+            /**
+             * Whether thinking is enabled or disabled.
+             */
+            type?: 'enabled' | 'disabled';
+        }
+    }
+    /**
+     * OpenRouter model configuration (OpenAI-compatible).
+     */
+    interface OpenRouterModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'openrouter';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * ChatGPT OAuth model configuration (uses ChatGPT backend API).
+     */
+    interface ChatGptoAuthModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'chatgpt_oauth';
+        /**
+         * The reasoning configuration for the model.
+         */
+        reasoning?: ChatGptoAuthModelSettings.Reasoning;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    namespace ChatGptoAuthModelSettings {
+        /**
+         * The reasoning configuration for the model.
+         */
+        interface Reasoning {
+            /**
+             * The reasoning effort level for GPT-5.x and o-series models.
+             */
+            reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
+        }
+    }
+}
 /**
  * Request model for creating a new conversation.
  */
@@ -80,21 +206,254 @@ export interface CreateConversation {
      * blocks with these labels.
      */
     isolated_block_labels?: Array<string> | null;
+    /**
+     * The model handle for this conversation (overrides agent's model). Format:
+     * provider/model-name.
+     */
+    model?: string | null;
+    /**
+     * The model settings for this conversation (overrides agent's model settings).
+     */
+    model_settings?: AgentsAPI.OpenAIModelSettings | AgentsAPI.AnthropicModelSettings | AgentsAPI.GoogleAIModelSettings | AgentsAPI.GoogleVertexModelSettings | AgentsAPI.AzureModelSettings | AgentsAPI.XaiModelSettings | CreateConversation.ZaiModelSettings | AgentsAPI.GroqModelSettings | AgentsAPI.DeepseekModelSettings | AgentsAPI.TogetherModelSettings | AgentsAPI.BedrockModelSettings | CreateConversation.OpenRouterModelSettings | CreateConversation.ChatGptoAuthModelSettings | null;
     /**
      * A summary of the conversation.
      */
     summary?: string | null;
 }
+export declare namespace CreateConversation {
+    /**
+     * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
+     */
+    interface ZaiModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'zai';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        thinking?: ZaiModelSettings.Thinking;
+    }
+    namespace ZaiModelSettings {
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        interface Thinking {
+            /**
+             * If False, preserved thinking is used (recommended for agents).
+             */
+            clear_thinking?: boolean;
+            /**
+             * Whether thinking is enabled or disabled.
+             */
+            type?: 'enabled' | 'disabled';
+        }
+    }
+    /**
+     * OpenRouter model configuration (OpenAI-compatible).
+     */
+    interface OpenRouterModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'openrouter';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * ChatGPT OAuth model configuration (uses ChatGPT backend API).
+     */
+    interface ChatGptoAuthModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'chatgpt_oauth';
+        /**
+         * The reasoning configuration for the model.
+         */
+        reasoning?: ChatGptoAuthModelSettings.Reasoning;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    namespace ChatGptoAuthModelSettings {
+        /**
+         * The reasoning configuration for the model.
+         */
+        interface Reasoning {
+            /**
+             * The reasoning effort level for GPT-5.x and o-series models.
+             */
+            reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
+        }
+    }
+}
 /**
  * Request model for updating a conversation.
  */
 export interface UpdateConversation {
+    /**
+     * The model handle for this conversation (overrides agent's model). Format:
+     * provider/model-name.
+     */
+    model?: string | null;
+    /**
+     * The model settings for this conversation (overrides agent's model settings).
+     */
+    model_settings?: AgentsAPI.OpenAIModelSettings | AgentsAPI.AnthropicModelSettings | AgentsAPI.GoogleAIModelSettings | AgentsAPI.GoogleVertexModelSettings | AgentsAPI.AzureModelSettings | AgentsAPI.XaiModelSettings | UpdateConversation.ZaiModelSettings | AgentsAPI.GroqModelSettings | AgentsAPI.DeepseekModelSettings | AgentsAPI.TogetherModelSettings | AgentsAPI.BedrockModelSettings | UpdateConversation.OpenRouterModelSettings | UpdateConversation.ChatGptoAuthModelSettings | null;
     /**
      * A summary of the conversation.
      */
     summary?: string | null;
 }
+export declare namespace UpdateConversation {
+    /**
+     * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
+     */
+    interface ZaiModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'zai';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        thinking?: ZaiModelSettings.Thinking;
+    }
+    namespace ZaiModelSettings {
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        interface Thinking {
+            /**
+             * If False, preserved thinking is used (recommended for agents).
+             */
+            clear_thinking?: boolean;
+            /**
+             * Whether thinking is enabled or disabled.
+             */
+            type?: 'enabled' | 'disabled';
+        }
+    }
+    /**
+     * OpenRouter model configuration (OpenAI-compatible).
+     */
+    interface OpenRouterModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'openrouter';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * ChatGPT OAuth model configuration (uses ChatGPT backend API).
+     */
+    interface ChatGptoAuthModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'chatgpt_oauth';
+        /**
+         * The reasoning configuration for the model.
+         */
+        reasoning?: ChatGptoAuthModelSettings.Reasoning;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    namespace ChatGptoAuthModelSettings {
+        /**
+         * The reasoning configuration for the model.
+         */
+        interface Reasoning {
+            /**
+             * The reasoning effort level for GPT-5.x and o-series models.
+             */
+            reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
+        }
+    }
+}
 export type ConversationListResponse = Array<Conversation>;
+export type ConversationDeleteResponse = unknown;
 export type ConversationCancelResponse = {
     [key: string]: unknown;
 };
@@ -109,37 +468,279 @@ export interface ConversationCreateParams {
      * the agent's blocks with these labels.
      */
     isolated_block_labels?: Array<string> | null;
+    /**
+     * Body param: The model handle for this conversation (overrides agent's model).
+     * Format: provider/model-name.
+     */
+    model?: string | null;
+    /**
+     * Body param: The model settings for this conversation (overrides agent's model
+     * settings).
+     */
+    model_settings?: AgentsAPI.OpenAIModelSettings | AgentsAPI.AnthropicModelSettings | AgentsAPI.GoogleAIModelSettings | AgentsAPI.GoogleVertexModelSettings | AgentsAPI.AzureModelSettings | AgentsAPI.XaiModelSettings | ConversationCreateParams.ZaiModelSettings | AgentsAPI.GroqModelSettings | AgentsAPI.DeepseekModelSettings | AgentsAPI.TogetherModelSettings | AgentsAPI.BedrockModelSettings | ConversationCreateParams.OpenRouterModelSettings | ConversationCreateParams.ChatGptoAuthModelSettings | null;
     /**
      * Body param: A summary of the conversation.
      */
     summary?: string | null;
 }
+export declare namespace ConversationCreateParams {
+    /**
+     * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
+     */
+    interface ZaiModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'zai';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        thinking?: ZaiModelSettings.Thinking;
+    }
+    namespace ZaiModelSettings {
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        interface Thinking {
+            /**
+             * If False, preserved thinking is used (recommended for agents).
+             */
+            clear_thinking?: boolean;
+            /**
+             * Whether thinking is enabled or disabled.
+             */
+            type?: 'enabled' | 'disabled';
+        }
+    }
+    /**
+     * OpenRouter model configuration (OpenAI-compatible).
+     */
+    interface OpenRouterModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'openrouter';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * ChatGPT OAuth model configuration (uses ChatGPT backend API).
+     */
+    interface ChatGptoAuthModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'chatgpt_oauth';
+        /**
+         * The reasoning configuration for the model.
+         */
+        reasoning?: ChatGptoAuthModelSettings.Reasoning;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    namespace ChatGptoAuthModelSettings {
+        /**
+         * The reasoning configuration for the model.
+         */
+        interface Reasoning {
+            /**
+             * The reasoning effort level for GPT-5.x and o-series models.
+             */
+            reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
+        }
+    }
+}
 export interface ConversationUpdateParams {
+    /**
+     * The model handle for this conversation (overrides agent's model). Format:
+     * provider/model-name.
+     */
+    model?: string | null;
+    /**
+     * The model settings for this conversation (overrides agent's model settings).
+     */
+    model_settings?: AgentsAPI.OpenAIModelSettings | AgentsAPI.AnthropicModelSettings | AgentsAPI.GoogleAIModelSettings | AgentsAPI.GoogleVertexModelSettings | AgentsAPI.AzureModelSettings | AgentsAPI.XaiModelSettings | ConversationUpdateParams.ZaiModelSettings | AgentsAPI.GroqModelSettings | AgentsAPI.DeepseekModelSettings | AgentsAPI.TogetherModelSettings | AgentsAPI.BedrockModelSettings | ConversationUpdateParams.OpenRouterModelSettings | ConversationUpdateParams.ChatGptoAuthModelSettings | null;
     /**
      * A summary of the conversation.
      */
     summary?: string | null;
 }
-export interface ConversationListParams {
+export declare namespace ConversationUpdateParams {
     /**
-     * The agent ID to list conversations for
+     * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
      */
-    agent_id: string;
+    interface ZaiModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'zai';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        thinking?: ZaiModelSettings.Thinking;
+    }
+    namespace ZaiModelSettings {
+        /**
+         * The thinking configuration for GLM-4.5+ models.
+         */
+        interface Thinking {
+            /**
+             * If False, preserved thinking is used (recommended for agents).
+             */
+            clear_thinking?: boolean;
+            /**
+             * Whether thinking is enabled or disabled.
+             */
+            type?: 'enabled' | 'disabled';
+        }
+    }
+    /**
+     * OpenRouter model configuration (OpenAI-compatible).
+     */
+    interface OpenRouterModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'openrouter';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * ChatGPT OAuth model configuration (uses ChatGPT backend API).
+     */
+    interface ChatGptoAuthModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The type of the provider.
+         */
+        provider_type?: 'chatgpt_oauth';
+        /**
+         * The reasoning configuration for the model.
+         */
+        reasoning?: ChatGptoAuthModelSettings.Reasoning;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    namespace ChatGptoAuthModelSettings {
+        /**
+         * The reasoning configuration for the model.
+         */
+        interface Reasoning {
+            /**
+             * The reasoning effort level for GPT-5.x and o-series models.
+             */
+            reasoning_effort?: 'none' | 'low' | 'medium' | 'high' | 'xhigh';
+        }
+    }
+}
+export interface ConversationListParams {
     /**
      * Cursor for pagination (conversation ID)
      */
     after?: string | null;
+    /**
+     * The agent ID to list conversations for (optional - returns all conversations if
+     * not provided)
+     */
+    agent_id?: string | null;
     /**
      * Maximum number of conversations to return
      */
     limit?: number;
+    /**
+     * Sort order for conversations. 'asc' for oldest first, 'desc' for newest first
+     */
+    order?: 'asc' | 'desc';
+    /**
+     * Field to sort by
+     */
+    order_by?: 'created_at' | 'last_run_completion';
     /**
      * Search for text within conversation summaries
      */
     summary_search?: string | null;
 }
 export declare namespace Conversations {
-    export { type Conversation as Conversation, type CreateConversation as CreateConversation, type UpdateConversation as UpdateConversation, type ConversationListResponse as ConversationListResponse, type ConversationCancelResponse as ConversationCancelResponse, type ConversationCreateParams as ConversationCreateParams, type ConversationUpdateParams as ConversationUpdateParams, type ConversationListParams as ConversationListParams, };
+    export { type Conversation as Conversation, type CreateConversation as CreateConversation, type UpdateConversation as UpdateConversation, type ConversationListResponse as ConversationListResponse, type ConversationDeleteResponse as ConversationDeleteResponse, type ConversationCancelResponse as ConversationCancelResponse, type ConversationCreateParams as ConversationCreateParams, type ConversationUpdateParams as ConversationUpdateParams, type ConversationListParams as ConversationListParams, };
     export { Messages as Messages, type CompactionRequest as CompactionRequest, type CompactionResponse as CompactionResponse, type MessageStreamResponse as MessageStreamResponse, type MessageCreateParams as MessageCreateParams, type MessageListParams as MessageListParams, type MessageCompactParams as MessageCompactParams, type MessageStreamParams as MessageStreamParams, };
 }
 //# sourceMappingURL=conversations.d.mts.map