@letta-ai/letta-client 1.0.0-alpha.16 → 1.0.0-alpha.18

package/resources/agents/agents.d.ts

@@ -108,16 +108,6 @@ export interface AgentEnvironmentVariable {
  * Representation of an agent's state. This is the state of the agent at a given
  * time, and is persisted in the DB backend. The state has all the information
  * needed to recreate a persisted agent.
- *
- * Parameters: id (str): The unique identifier of the agent. name (str): The name
- * of the agent (must be unique to the user). created_at (datetime): The datetime
- * the agent was created. message_ids (List[str]): The ids of the messages in the
- * agent's in-context memory. memory (Memory): The in-context memory of the agent.
- * tools (List[str]): The tools used by the agent. This includes any memory editing
- * functions specified in `memory`. system (str): The system prompt used by the
- * agent. llm_config (LLMConfig): The LLM configuration used by the agent.
- * embedding_config (EmbeddingConfig): The embedding configuration used by the
- * agent.
  */
 export interface AgentState {
     /**
@@ -188,9 +178,9 @@ export interface AgentState {
      */
     description?: string | null;
     /**
-     * The embedding model used by the agent.
+     * The embedding model handle used by the agent (format: provider/model-name).
      */
-    embedding?: AgentState.Embedding | null;
+    embedding?: string | null;
     /**
      * If set to True, memory management will move to a background agent thread.
      */
@@ -254,9 +244,13 @@ export interface AgentState {
         [key: string]: unknown;
     } | null;
     /**
-     * Schema for defining settings for a model
+     * The model handle used by the agent (format: provider/model-name).
      */
-    model?: AgentState.Model | null;
+    model?: string | null;
+    /**
+     * The model settings used by the agent.
+     */
+    model_settings?: AgentState.OpenAIModelSettings | AgentState.AnthropicModelSettings | AgentState.GoogleAIModelSettings | AgentState.GoogleVertexModelSettings | AgentState.AzureModelSettings | AgentState.XaiModelSettings | AgentState.GroqModelSettings | AgentState.DeepseekModelSettings | AgentState.TogetherModelSettings | AgentState.BedrockModelSettings | null;
     /**
      * @deprecated Deprecated: Use `managed_group` field instead. The multi-agent group
      * that this agent manages.
@@ -419,13 +413,8 @@ export declare namespace AgentState {
         }
     }
     /**
-     * Representation of a source, which is a collection of files and passages.
-     *
-     * Parameters: id (str): The ID of the source name (str): The name of the source.
-     * embedding_config (EmbeddingConfig): The embedding configuration used by the
-     * source. user_id (str): The ID of the user that created the source. metadata
-     * (dict): Metadata associated with the source. description (str): The description
-     * of the source.
+     * (Deprecated: Use Folder) Representation of a source, which is a collection of
+     * files and passages.
      */
     interface Source {
         /**
@@ -475,31 +464,315 @@ export declare namespace AgentState {
          */
         vector_db_provider?: ArchivesAPI.VectorDBProvider;
     }
+    interface OpenAIModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'openai';
+        /**
+         * The reasoning configuration for the model.
+         */
+        reasoning?: OpenAIModelSettings.Reasoning;
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    namespace OpenAIModelSettings {
+        /**
+         * The reasoning configuration for the model.
+         */
+        interface Reasoning {
+            /**
+             * The reasoning effort to use when generating text reasoning models
+             */
+            reasoning_effort?: 'minimal' | 'low' | 'medium' | 'high';
+        }
+    }
+    interface AnthropicModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'anthropic';
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for the model.
+         */
+        thinking?: AnthropicModelSettings.Thinking;
+        /**
+         * Soft control for how verbose model output should be, used for GPT-5 models.
+         */
+        verbosity?: 'low' | 'medium' | 'high' | null;
+    }
+    namespace AnthropicModelSettings {
+        /**
+         * The thinking configuration for the model.
+         */
+        interface Thinking {
+            /**
+             * The maximum number of tokens the model can use for extended thinking.
+             */
+            budget_tokens?: number;
+            /**
+             * The type of thinking to use.
+             */
+            type?: 'enabled' | 'disabled';
+        }
+    }
+    interface GoogleAIModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'google_ai';
+        /**
+         * The response schema for the model.
+         */
+        response_schema?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for the model.
+         */
+        thinking_config?: GoogleAIModelSettings.ThinkingConfig;
+    }
+    namespace GoogleAIModelSettings {
+        /**
+         * The thinking configuration for the model.
+         */
+        interface ThinkingConfig {
+            /**
+             * Whether to include thoughts in the model's response.
+             */
+            include_thoughts?: boolean;
+            /**
+             * The thinking budget for the model.
+             */
+            thinking_budget?: number;
+        }
+    }
+    interface GoogleVertexModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'google_vertex';
+        /**
+         * The response schema for the model.
+         */
+        response_schema?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for the model.
+         */
+        thinking_config?: GoogleVertexModelSettings.ThinkingConfig;
+    }
+    namespace GoogleVertexModelSettings {
+        /**
+         * The thinking configuration for the model.
+         */
+        interface ThinkingConfig {
+            /**
+             * Whether to include thoughts in the model's response.
+             */
+            include_thoughts?: boolean;
+            /**
+             * The thinking budget for the model.
+             */
+            thinking_budget?: number;
+        }
+    }
+    /**
+     * Azure OpenAI model configuration (OpenAI-compatible).
+     */
+    interface AzureModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'azure';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * xAI model configuration (OpenAI-compatible).
+     */
+    interface XaiModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'xai';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * Groq model configuration (OpenAI-compatible).
+     */
+    interface GroqModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'groq';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
     /**
-     * The embedding model used by the agent.
+     * Deepseek model configuration (OpenAI-compatible).
      */
-    interface Embedding {
+    interface DeepseekModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
         /**
-         * The name of the model.
+         * Whether to enable parallel tool calling.
          */
-        model: string;
+        parallel_tool_calls?: boolean;
         /**
          * The provider of the model.
          */
-        provider: 'openai' | 'ollama';
+        provider?: 'deepseek';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
     }
     /**
-     * Schema for defining settings for a model
+     * Together AI model configuration (OpenAI-compatible).
      */
-    interface Model {
+    interface TogetherModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'together';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
         /**
-         * The name of the model.
+         * The temperature of the model.
          */
-        model: string;
+        temperature?: number;
+    }
+    /**
+     * AWS Bedrock model configuration.
+     */
+    interface BedrockModelSettings {
         /**
          * The maximum number of tokens the model can generate.
          */
         max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'bedrock';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
     }
 }
 /**
@@ -811,10 +1084,9 @@ export interface AgentCreateParams {
      */
     description?: string | null;
     /**
-     * The embedding configuration handle used by the agent, specified in the format
-     * provider/model-name.
+     * The embedding model handle used by the agent (format: provider/model-name).
      */
-    embedding?: string | AgentCreateParams.EmbeddingModelSettings | null;
+    embedding?: string | null;
     /**
      * @deprecated Deprecated: No longer used. The embedding chunk size used by the
      * agent.
@@ -913,10 +1185,13 @@ export interface AgentCreateParams {
         [key: string]: unknown;
     } | null;
     /**
-     * The model handle or model settings for the agent to use, specified either by a
-     * handle or an object. See the model schema for more information.
+     * The model handle for the agent to use (format: provider/model-name).
      */
-    model?: string | AgentCreateParams.ModelSettings | null;
+    model?: string | null;
+    /**
+     * The model settings for the agent.
+     */
+    model_settings?: AgentCreateParams.OpenAIModelSettings | AgentCreateParams.AnthropicModelSettings | AgentCreateParams.GoogleAIModelSettings | AgentCreateParams.GoogleVertexModelSettings | AgentCreateParams.AzureModelSettings | AgentCreateParams.XaiModelSettings | AgentCreateParams.GroqModelSettings | AgentCreateParams.DeepseekModelSettings | AgentCreateParams.TogetherModelSettings | AgentCreateParams.BedrockModelSettings | null;
     /**
      * The name of the agent.
      */
@@ -1003,80 +1278,367 @@ export interface AgentCreateParams {
     tools?: Array<string> | null;
 }
 export declare namespace AgentCreateParams {
-    interface EmbeddingModelSettings {
+    interface OpenAIModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
         /**
-         * The name of the model.
+         * Whether to enable parallel tool calling.
          */
-        model: string;
+        parallel_tool_calls?: boolean;
         /**
          * The provider of the model.
          */
-        provider: 'openai' | 'ollama';
+        provider?: 'openai';
+        /**
+         * The reasoning configuration for the model.
+         */
+        reasoning?: OpenAIModelSettings.Reasoning;
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
     }
-    /**
-     * Schema for defining settings for a model
-     */
-    interface ModelSettings {
+    namespace OpenAIModelSettings {
         /**
-         * The name of the model.
+         * The reasoning configuration for the model.
          */
-        model: string;
+        interface Reasoning {
+            /**
+             * The reasoning effort to use when generating text reasoning models
+             */
+            reasoning_effort?: 'minimal' | 'low' | 'medium' | 'high';
+        }
+    }
+    interface AnthropicModelSettings {
         /**
          * The maximum number of tokens the model can generate.
          */
         max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'anthropic';
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for the model.
+         */
+        thinking?: AnthropicModelSettings.Thinking;
+        /**
+         * Soft control for how verbose model output should be, used for GPT-5 models.
+         */
+        verbosity?: 'low' | 'medium' | 'high' | null;
     }
-}
-export interface AgentRetrieveParams {
-    /**
-     * Specify which relational fields to include in the response. No relationships are
-     * included by default.
-     */
-    include?: Array<'agent.blocks' | 'agent.identities' | 'agent.managed_group' | 'agent.secrets' | 'agent.sources' | 'agent.tags' | 'agent.tools'>;
-    /**
-     * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
-     * in the response. If not provided, all relationships are loaded by default. Using
-     * this can optimize performance by reducing unnecessary joins.This is a legacy
-     * parameter, and no longer supported after 1.0.0 SDK versions.
-     */
-    include_relationships?: Array<string> | null;
-}
-export interface AgentListParams extends ArrayPageParams {
-    /**
-     * @deprecated Whether to sort agents oldest to newest (True) or newest to oldest
-     * (False, default)
-     */
-    ascending?: boolean;
-    /**
-     * Search agents by base template ID
-     */
-    base_template_id?: string | null;
-    /**
-     * Search agents by identifier keys
-     */
-    identifier_keys?: Array<string> | null;
-    /**
-     * Search agents by identity ID
-     */
-    identity_id?: string | null;
-    /**
-     * Specify which relational fields to include in the response. No relationships are
-     * included by default.
-     */
-    include?: Array<'agent.blocks' | 'agent.identities' | 'agent.managed_group' | 'agent.secrets' | 'agent.sources' | 'agent.tags' | 'agent.tools'>;
-    /**
-     * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
-     * in the response. If not provided, all relationships are loaded by default. Using
-     * this can optimize performance by reducing unnecessary joins.This is a legacy
-     * parameter, and no longer supported after 1.0.0 SDK versions.
-     */
-    include_relationships?: Array<string> | null;
-    /**
-     * Filter agents by their last stop reason.
-     */
-    last_stop_reason?: RunsAPI.StopReasonType | null;
-    /**
-     * If True, only returns agents that match ALL given tags. Otherwise, return agents
+    namespace AnthropicModelSettings {
+        /**
+         * The thinking configuration for the model.
+         */
+        interface Thinking {
+            /**
+             * The maximum number of tokens the model can use for extended thinking.
+             */
+            budget_tokens?: number;
+            /**
+             * The type of thinking to use.
+             */
+            type?: 'enabled' | 'disabled';
+        }
+    }
+    interface GoogleAIModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'google_ai';
+        /**
+         * The response schema for the model.
+         */
+        response_schema?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for the model.
+         */
+        thinking_config?: GoogleAIModelSettings.ThinkingConfig;
+    }
+    namespace GoogleAIModelSettings {
+        /**
+         * The thinking configuration for the model.
+         */
+        interface ThinkingConfig {
+            /**
+             * Whether to include thoughts in the model's response.
+             */
+            include_thoughts?: boolean;
+            /**
+             * The thinking budget for the model.
+             */
+            thinking_budget?: number;
+        }
+    }
+    interface GoogleVertexModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'google_vertex';
+        /**
+         * The response schema for the model.
+         */
+        response_schema?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for the model.
+         */
+        thinking_config?: GoogleVertexModelSettings.ThinkingConfig;
+    }
+    namespace GoogleVertexModelSettings {
+        /**
+         * The thinking configuration for the model.
+         */
+        interface ThinkingConfig {
+            /**
+             * Whether to include thoughts in the model's response.
+             */
+            include_thoughts?: boolean;
+            /**
+             * The thinking budget for the model.
+             */
+            thinking_budget?: number;
+        }
+    }
+    /**
+     * Azure OpenAI model configuration (OpenAI-compatible).
+     */
+    interface AzureModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'azure';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * xAI model configuration (OpenAI-compatible).
+     */
+    interface XaiModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'xai';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * Groq model configuration (OpenAI-compatible).
+     */
+    interface GroqModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'groq';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * Deepseek model configuration (OpenAI-compatible).
+     */
+    interface DeepseekModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'deepseek';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * Together AI model configuration (OpenAI-compatible).
+     */
+    interface TogetherModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'together';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * AWS Bedrock model configuration.
+     */
+    interface BedrockModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'bedrock';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+}
+export interface AgentRetrieveParams {
+    /**
+     * Specify which relational fields to include in the response. No relationships are
+     * included by default.
+     */
+    include?: Array<'agent.blocks' | 'agent.identities' | 'agent.managed_group' | 'agent.secrets' | 'agent.sources' | 'agent.tags' | 'agent.tools'>;
+    /**
+     * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
+     * in the response. If not provided, all relationships are loaded by default. Using
+     * this can optimize performance by reducing unnecessary joins.This is a legacy
+     * parameter, and no longer supported after 1.0.0 SDK versions.
+     */
+    include_relationships?: Array<string> | null;
+}
+export interface AgentListParams extends ArrayPageParams {
+    /**
+     * @deprecated Whether to sort agents oldest to newest (True) or newest to oldest
+     * (False, default)
+     */
+    ascending?: boolean;
+    /**
+     * Search agents by base template ID
+     */
+    base_template_id?: string | null;
+    /**
+     * Search agents by identifier keys
+     */
+    identifier_keys?: Array<string> | null;
+    /**
+     * Search agents by identity ID
+     */
+    identity_id?: string | null;
+    /**
+     * Specify which relational fields to include in the response. No relationships are
+     * included by default.
+     */
+    include?: Array<'agent.blocks' | 'agent.identities' | 'agent.managed_group' | 'agent.secrets' | 'agent.sources' | 'agent.tags' | 'agent.tools'>;
+    /**
+     * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
+     * in the response. If not provided, all relationships are loaded by default. Using
+     * this can optimize performance by reducing unnecessary joins.This is a legacy
+     * parameter, and no longer supported after 1.0.0 SDK versions.
+     */
+    include_relationships?: Array<string> | null;
+    /**
+     * Filter agents by their last stop reason.
+     */
+    last_stop_reason?: RunsAPI.StopReasonType | null;
+    /**
+     * If True, only returns agents that match ALL given tags. Otherwise, return agents
      * that have ANY of the passed-in tags.
      */
     match_all_tags?: boolean;
@@ -1178,10 +1740,9 @@ export interface AgentModifyParams {
      */
     description?: string | null;
     /**
-     * The embedding configuration handle used by the agent, specified in the format
-     * provider/model-name.
+     * The embedding model handle used by the agent (format: provider/model-name).
      */
-    embedding?: string | AgentModifyParams.EmbeddingModelSettings | null;
+    embedding?: string | null;
     /**
      * Configuration for embedding model connection and processing parameters.
      */
@@ -1241,10 +1802,13 @@ export interface AgentModifyParams {
         [key: string]: unknown;
     } | null;
     /**
-     * The model used by the agent, specified either by a handle or an object. See the
-     * model schema for more information.
+     * The model handle used by the agent (format: provider/model-name).
+     */
+    model?: string | null;
+    /**
+     * The model settings for the agent.
      */
-    model?: string | AgentModifyParams.ModelSettings | null;
+    model_settings?: AgentModifyParams.OpenAIModelSettings | AgentModifyParams.AnthropicModelSettings | AgentModifyParams.GoogleAIModelSettings | AgentModifyParams.GoogleVertexModelSettings | AgentModifyParams.AzureModelSettings | AgentModifyParams.XaiModelSettings | AgentModifyParams.GroqModelSettings | AgentModifyParams.DeepseekModelSettings | AgentModifyParams.TogetherModelSettings | AgentModifyParams.BedrockModelSettings | null;
     /**
      * The name of the agent.
      */
@@ -1315,28 +1879,315 @@ export interface AgentModifyParams {
     tool_rules?: Array<ChildToolRule | InitToolRule | TerminalToolRule | ConditionalToolRule | ContinueToolRule | RequiredBeforeExitToolRule | MaxCountPerStepToolRule | ParentToolRule | RequiresApprovalToolRule> | null;
 }
 export declare namespace AgentModifyParams {
-    interface EmbeddingModelSettings {
+    interface OpenAIModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'openai';
+        /**
+         * The reasoning configuration for the model.
+         */
+        reasoning?: OpenAIModelSettings.Reasoning;
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    namespace OpenAIModelSettings {
+        /**
+         * The reasoning configuration for the model.
+         */
+        interface Reasoning {
+            /**
+             * The reasoning effort to use when generating text reasoning models
+             */
+            reasoning_effort?: 'minimal' | 'low' | 'medium' | 'high';
+        }
+    }
+    interface AnthropicModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'anthropic';
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for the model.
+         */
+        thinking?: AnthropicModelSettings.Thinking;
+        /**
+         * Soft control for how verbose model output should be, used for GPT-5 models.
+         */
+        verbosity?: 'low' | 'medium' | 'high' | null;
+    }
+    namespace AnthropicModelSettings {
+        /**
+         * The thinking configuration for the model.
+         */
+        interface Thinking {
+            /**
+             * The maximum number of tokens the model can use for extended thinking.
+             */
+            budget_tokens?: number;
+            /**
+             * The type of thinking to use.
+             */
+            type?: 'enabled' | 'disabled';
+        }
+    }
+    interface GoogleAIModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'google_ai';
+        /**
+         * The response schema for the model.
+         */
+        response_schema?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for the model.
+         */
+        thinking_config?: GoogleAIModelSettings.ThinkingConfig;
+    }
+    namespace GoogleAIModelSettings {
+        /**
+         * The thinking configuration for the model.
+         */
+        interface ThinkingConfig {
+            /**
+             * Whether to include thoughts in the model's response.
+             */
+            include_thoughts?: boolean;
+            /**
+             * The thinking budget for the model.
+             */
+            thinking_budget?: number;
+        }
+    }
+    interface GoogleVertexModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'google_vertex';
+        /**
+         * The response schema for the model.
+         */
+        response_schema?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+        /**
+         * The thinking configuration for the model.
+         */
+        thinking_config?: GoogleVertexModelSettings.ThinkingConfig;
+    }
+    namespace GoogleVertexModelSettings {
+        /**
+         * The thinking configuration for the model.
+         */
+        interface ThinkingConfig {
+            /**
+             * Whether to include thoughts in the model's response.
+             */
+            include_thoughts?: boolean;
+            /**
+             * The thinking budget for the model.
+             */
+            thinking_budget?: number;
+        }
+    }
+    /**
+     * Azure OpenAI model configuration (OpenAI-compatible).
+     */
+    interface AzureModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
         /**
-         * The name of the model.
+         * Whether to enable parallel tool calling.
          */
-        model: string;
+        parallel_tool_calls?: boolean;
         /**
          * The provider of the model.
          */
-        provider: 'openai' | 'ollama';
+        provider?: 'azure';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
     }
     /**
-     * Schema for defining settings for a model
+     * xAI model configuration (OpenAI-compatible).
      */
-    interface ModelSettings {
+    interface XaiModelSettings {
         /**
-         * The name of the model.
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'xai';
+        /**
+         * The response format for the model.
          */
-        model: string;
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * Groq model configuration (OpenAI-compatible).
+     */
+    interface GroqModelSettings {
         /**
          * The maximum number of tokens the model can generate.
          */
         max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'groq';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * Deepseek model configuration (OpenAI-compatible).
+     */
+    interface DeepseekModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'deepseek';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * Together AI model configuration (OpenAI-compatible).
+     */
+    interface TogetherModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'together';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
+    }
+    /**
+     * AWS Bedrock model configuration.
+     */
+    interface BedrockModelSettings {
+        /**
+         * The maximum number of tokens the model can generate.
+         */
+        max_output_tokens?: number;
+        /**
+         * Whether to enable parallel tool calling.
+         */
+        parallel_tool_calls?: boolean;
+        /**
+         * The provider of the model.
+         */
+        provider?: 'bedrock';
+        /**
+         * The response format for the model.
+         */
+        response_format?: AgentsAPI.TextResponseFormat | AgentsAPI.JsonSchemaResponseFormat | AgentsAPI.JsonObjectResponseFormat | null;
+        /**
+         * The temperature of the model.
+         */
+        temperature?: number;
     }
 }
 export declare namespace Agents {