@letta-ai/letta-client 1.7.8 → 1.7.9

package/src/resources/conversations/conversations.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from './messages';
 import {
   CompactionRequest,
@@ -46,12 +47,27 @@ export class Conversations extends APIResource {
   }
 
   /**
-   * 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> {
     return this._client.get('/v1/conversations/', { query, ...options });
   }
 
+  /**
+   * 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> {
+    return this._client.delete(path`/v1/conversations/${conversationID}`, options);
+  }
+
   /**
    * Cancel runs associated with a conversation.
    *
@@ -102,6 +118,31 @@ export interface Conversation {
    */
   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.
    */
@@ -113,6 +154,140 @@ export interface Conversation {
   updated_at?: string | null;
 }
 
+export namespace Conversation {
+  /**
+   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
+   */
+  export 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;
+  }
+
+  export namespace ZaiModelSettings {
+    /**
+     * The thinking configuration for GLM-4.5+ models.
+     */
+    export 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).
+   */
+  export 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).
+   */
+  export 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;
+  }
+
+  export namespace ChatGptoAuthModelSettings {
+    /**
+     * The reasoning configuration for the model.
+     */
+    export 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.
  */
@@ -124,24 +299,344 @@ export interface CreateConversation {
    */
   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 namespace CreateConversation {
+  /**
+   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
+   */
+  export 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;
+  }
+
+  export namespace ZaiModelSettings {
+    /**
+     * The thinking configuration for GLM-4.5+ models.
+     */
+    export 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).
+   */
+  export 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).
+   */
+  export 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;
+  }
+
+  export namespace ChatGptoAuthModelSettings {
+    /**
+     * The reasoning configuration for the model.
+     */
+    export 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 namespace UpdateConversation {
+  /**
+   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
+   */
+  export 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;
+  }
+
+  export namespace ZaiModelSettings {
+    /**
+     * The thinking configuration for GLM-4.5+ models.
+     */
+    export 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).
+   */
+  export 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).
+   */
+  export 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;
+  }
+
+  export namespace ChatGptoAuthModelSettings {
+    /**
+     * The reasoning configuration for the model.
+     */
+    export 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 };
 
 export interface ConversationCreateParams {
@@ -157,35 +652,365 @@ export interface ConversationCreateParams {
    */
   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 namespace ConversationCreateParams {
+  /**
+   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
+   */
+  export 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;
+  }
+
+  export namespace ZaiModelSettings {
+    /**
+     * The thinking configuration for GLM-4.5+ models.
+     */
+    export 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).
+   */
+  export 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).
+   */
+  export 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;
+  }
+
+  export namespace ChatGptoAuthModelSettings {
+    /**
+     * The reasoning configuration for the model.
+     */
+    export 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 namespace ConversationUpdateParams {
   /**
-   * The agent ID to list conversations for
+   * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
    */
-  agent_id: string;
+  export 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;
+  }
+
+  export namespace ZaiModelSettings {
+    /**
+     * The thinking configuration for GLM-4.5+ models.
+     */
+    export 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).
+   */
+  export 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).
+   */
+  export 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;
+  }
+
+  export namespace ChatGptoAuthModelSettings {
+    /**
+     * The reasoning configuration for the model.
+     */
+    export 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
    */
@@ -200,6 +1025,7 @@ export declare namespace Conversations {
     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,