@letta-ai/letta-client 1.0.0-alpha.17 → 1.0.0-alpha.19

package/src/resources/agents/agents.ts

@@ -2,8 +2,15 @@
 
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from './agents';
-import * as ArchivesAPI from '../archives';
 import * as ToolsAPI from '../tools';
+import * as ArchivesAPI from './archives';
+import {
+  ArchiveAttachParams,
+  ArchiveAttachResponse,
+  ArchiveDetachParams,
+  ArchiveDetachResponse,
+  Archives,
+} from './archives';
 import * as BlocksAPI from './blocks';
 import {
   Block,
@@ -38,20 +45,28 @@ import {
 } from './folders';
 import * as GroupsAPI from './groups';
 import { GroupListParams, Groups } from './groups';
+import * as IdentitiesAPI from './identities';
+import {
+  Identities,
+  IdentityAttachParams,
+  IdentityAttachResponse,
+  IdentityDetachParams,
+  IdentityDetachResponse,
+} from './identities';
 import * as MessagesAPI from './messages';
 import {
   ApprovalCreate,
   ApprovalRequestMessage,
   ApprovalResponseMessage,
+  ApprovalReturn,
   AssistantMessage,
   EventMessage,
   HiddenReasoningMessage,
   ImageContent,
+  InternalMessage,
   JobStatus,
   JobType,
   LettaAssistantMessageContentUnion,
-  LettaMessageUnion,
-  LettaMessageUnionsArrayPage,
   LettaRequest,
   LettaResponse,
   LettaStreamingRequest,
@@ -72,6 +87,7 @@ import {
   MessageStreamParams,
   MessageType,
   Messages,
+  MessagesArrayPage,
   OmittedReasoningContent,
   ReasoningContent,
   ReasoningMessage,
@@ -94,9 +110,10 @@ import {
 } from './messages';
 import * as AgentsToolsAPI from './tools';
 import { ToolAttachParams, ToolDetachParams, ToolListParams, ToolUpdateApprovalParams, Tools } from './tools';
+import * as ArchivesArchivesAPI from '../archives/archives';
 import * as BlocksBlocksAPI from '../blocks/blocks';
 import * as GroupsGroupsAPI from '../groups/groups';
-import * as IdentitiesAPI from '../identities/identities';
+import * as IdentitiesIdentitiesAPI from '../identities/identities';
 import * as ModelsAPI from '../models/models';
 import * as RunsAPI from '../runs/runs';
 import { APIPromise } from '../../core/api-promise';
@@ -108,12 +125,14 @@ import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
 
 export class Agents extends APIResource {
+  messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
+  blocks: BlocksAPI.Blocks = new BlocksAPI.Blocks(this._client);
   tools: AgentsToolsAPI.Tools = new AgentsToolsAPI.Tools(this._client);
   folders: FoldersAPI.Folders = new FoldersAPI.Folders(this._client);
   files: FilesAPI.Files = new FilesAPI.Files(this._client);
-  blocks: BlocksAPI.Blocks = new BlocksAPI.Blocks(this._client);
   groups: GroupsAPI.Groups = new GroupsAPI.Groups(this._client);
-  messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
+  archives: ArchivesAPI.Archives = new ArchivesAPI.Archives(this._client);
+  identities: IdentitiesAPI.Identities = new IdentitiesAPI.Identities(this._client);
 
   /**
    * Create an agent.
@@ -362,7 +381,7 @@ export interface AgentState {
   /**
    * The identities associated with this agent.
    */
-  identities?: Array<IdentitiesAPI.Identity>;
+  identities?: Array<IdentitiesIdentitiesAPI.Identity>;
 
   /**
    * @deprecated Deprecated: Use `identities` field instead. The ids of the
@@ -427,16 +446,16 @@ export interface AgentState {
    * 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
+    | OpenAIModelSettings
+    | AnthropicModelSettings
+    | GoogleAIModelSettings
+    | GoogleVertexModelSettings
+    | AzureModelSettings
+    | XaiModelSettings
+    | GroqModelSettings
+    | DeepseekModelSettings
+    | TogetherModelSettings
+    | BedrockModelSettings
     | null;
 
   /**
@@ -702,431 +721,133 @@ export namespace AgentState {
     /**
      * The vector database provider used for this source's passages
      */
-    vector_db_provider?: ArchivesAPI.VectorDBProvider;
-  }
-
-  export 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;
-  }
-
-  export namespace OpenAIModelSettings {
-    /**
-     * The reasoning configuration for the model.
-     */
-    export interface Reasoning {
-      /**
-       * The reasoning effort to use when generating text reasoning models
-       */
-      reasoning_effort?: 'minimal' | 'low' | 'medium' | 'high';
-    }
-  }
-
-  export 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 namespace AnthropicModelSettings {
-    /**
-     * The thinking configuration for the model.
-     */
-    export 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';
-    }
-  }
-
-  export 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;
-  }
-
-  export namespace GoogleAIModelSettings {
-    /**
-     * The thinking configuration for the model.
-     */
-    export interface ThinkingConfig {
-      /**
-       * Whether to include thoughts in the model's response.
-       */
-      include_thoughts?: boolean;
-
-      /**
-       * The thinking budget for the model.
-       */
-      thinking_budget?: number;
-    }
-  }
-
-  export 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;
+    vector_db_provider?: ArchivesArchivesAPI.VectorDBProvider;
   }
+}
 
-  export namespace GoogleVertexModelSettings {
-    /**
-     * The thinking configuration for the model.
-     */
-    export interface ThinkingConfig {
-      /**
-       * Whether to include thoughts in the model's response.
-       */
-      include_thoughts?: boolean;
-
-      /**
-       * The thinking budget for the model.
-       */
-      thinking_budget?: number;
-    }
-  }
+/**
+ * Enum to represent the type of agent.
+ */
+export type AgentType =
+  | 'memgpt_agent'
+  | 'memgpt_v2_agent'
+  | 'letta_v1_agent'
+  | 'react_agent'
+  | 'workflow_agent'
+  | 'split_thread_agent'
+  | 'sleeptime_agent'
+  | 'voice_convo_agent'
+  | 'voice_sleeptime_agent';
 
+export interface AnthropicModelSettings {
   /**
-   * Azure OpenAI model configuration (OpenAI-compatible).
+   * The maximum number of tokens the model can generate.
    */
-  export 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;
-  }
+  max_output_tokens?: number;
 
   /**
-   * xAI model configuration (OpenAI-compatible).
+   * Whether to enable parallel tool calling.
    */
-  export 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;
-  }
+  parallel_tool_calls?: boolean;
 
   /**
-   * Groq model configuration (OpenAI-compatible).
+   * The type of the provider.
    */
-  export 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;
-  }
+  provider_type?: 'anthropic';
 
   /**
-   * Deepseek model configuration (OpenAI-compatible).
+   * The temperature of the model.
    */
-  export interface DeepseekModelSettings {
-    /**
-     * The maximum number of tokens the model can generate.
-     */
-    max_output_tokens?: number;
+  temperature?: number;
 
-    /**
-     * Whether to enable parallel tool calling.
-     */
-    parallel_tool_calls?: boolean;
+  /**
+   * The thinking configuration for the model.
+   */
+  thinking?: AnthropicModelSettings.Thinking;
 
-    /**
-     * The provider of the model.
-     */
-    provider?: 'deepseek';
+  /**
+   * Soft control for how verbose model output should be, used for GPT-5 models.
+   */
+  verbosity?: 'low' | 'medium' | 'high' | null;
+}
 
+export namespace AnthropicModelSettings {
+  /**
+   * The thinking configuration for the model.
+   */
+  export interface Thinking {
     /**
-     * The response format for the model.
+     * The maximum number of tokens the model can use for extended thinking.
      */
-    response_format?:
-      | AgentsAPI.TextResponseFormat
-      | AgentsAPI.JsonSchemaResponseFormat
-      | AgentsAPI.JsonObjectResponseFormat
-      | null;
+    budget_tokens?: number;
 
     /**
-     * The temperature of the model.
+     * The type of thinking to use.
      */
-    temperature?: number;
+    type?: 'enabled' | 'disabled';
   }
+}
 
+/**
+ * Azure OpenAI model configuration (OpenAI-compatible).
+ */
+export interface AzureModelSettings {
   /**
-   * Together AI model configuration (OpenAI-compatible).
+   * The maximum number of tokens the model can generate.
    */
-  export interface TogetherModelSettings {
-    /**
-     * The maximum number of tokens the model can generate.
-     */
-    max_output_tokens?: number;
+  max_output_tokens?: number;
 
-    /**
-     * Whether to enable parallel tool calling.
-     */
-    parallel_tool_calls?: boolean;
+  /**
+   * Whether to enable parallel tool calling.
+   */
+  parallel_tool_calls?: boolean;
 
-    /**
-     * The provider of the model.
-     */
-    provider?: 'together';
+  /**
+   * The type of the provider.
+   */
+  provider_type?: 'azure';
 
-    /**
-     * The response format for the model.
-     */
-    response_format?:
-      | AgentsAPI.TextResponseFormat
-      | AgentsAPI.JsonSchemaResponseFormat
-      | AgentsAPI.JsonObjectResponseFormat
-      | null;
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
 
-    /**
-     * The temperature of the model.
-     */
-    temperature?: number;
-  }
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
+}
 
+/**
+ * AWS Bedrock model configuration.
+ */
+export interface BedrockModelSettings {
   /**
-   * AWS Bedrock model configuration.
+   * The maximum number of tokens the model can generate.
    */
-  export interface BedrockModelSettings {
-    /**
-     * The maximum number of tokens the model can generate.
-     */
-    max_output_tokens?: number;
+  max_output_tokens?: number;
 
-    /**
-     * Whether to enable parallel tool calling.
-     */
-    parallel_tool_calls?: boolean;
+  /**
+   * Whether to enable parallel tool calling.
+   */
+  parallel_tool_calls?: boolean;
 
-    /**
-     * The provider of the model.
-     */
-    provider?: 'bedrock';
+  /**
+   * The type of the provider.
+   */
+  provider_type?: 'bedrock';
 
-    /**
-     * The response format for the model.
-     */
-    response_format?:
-      | AgentsAPI.TextResponseFormat
-      | AgentsAPI.JsonSchemaResponseFormat
-      | AgentsAPI.JsonObjectResponseFormat
-      | null;
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
 
-    /**
-     * The temperature of the model.
-     */
-    temperature?: number;
-  }
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
 }
 
-/**
- * Enum to represent the type of agent.
- */
-export type AgentType =
-  | 'memgpt_agent'
-  | 'memgpt_v2_agent'
-  | 'letta_v1_agent'
-  | 'react_agent'
-  | 'workflow_agent'
-  | 'split_thread_agent'
-  | 'sleeptime_agent'
-  | 'voice_convo_agent'
-  | 'voice_sleeptime_agent';
-
 /**
  * A ToolRule represents a tool that can be invoked by the agent.
  */
@@ -1228,17 +949,175 @@ export interface ContinueToolRule {
 }
 
 /**
- * Represents the initial tool rule configuration.
+ * Deepseek model configuration (OpenAI-compatible).
  */
-export interface InitToolRule {
+export interface DeepseekModelSettings {
   /**
-   * The name of the tool. Must exist in the database for the user's organization.
+   * The maximum number of tokens the model can generate.
    */
-  tool_name: string;
+  max_output_tokens?: number;
 
   /**
-   * Optional prefilled arguments for this tool. When present, these values will
-   * override any LLM-provided arguments with the same keys during invocation. Keys
+   * Whether to enable parallel tool calling.
+   */
+  parallel_tool_calls?: boolean;
+
+  /**
+   * The type of the provider.
+   */
+  provider_type?: 'deepseek';
+
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
+}
+
+export 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 type of the provider.
+   */
+  provider_type?: 'google_ai';
+
+  /**
+   * The response schema for the model.
+   */
+  response_schema?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
+
+  /**
+   * The thinking configuration for the model.
+   */
+  thinking_config?: GoogleAIModelSettings.ThinkingConfig;
+}
+
+export namespace GoogleAIModelSettings {
+  /**
+   * The thinking configuration for the model.
+   */
+  export interface ThinkingConfig {
+    /**
+     * Whether to include thoughts in the model's response.
+     */
+    include_thoughts?: boolean;
+
+    /**
+     * The thinking budget for the model.
+     */
+    thinking_budget?: number;
+  }
+}
+
+export 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 type of the provider.
+   */
+  provider_type?: 'google_vertex';
+
+  /**
+   * The response schema for the model.
+   */
+  response_schema?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
+
+  /**
+   * The thinking configuration for the model.
+   */
+  thinking_config?: GoogleVertexModelSettings.ThinkingConfig;
+}
+
+export namespace GoogleVertexModelSettings {
+  /**
+   * The thinking configuration for the model.
+   */
+  export interface ThinkingConfig {
+    /**
+     * Whether to include thoughts in the model's response.
+     */
+    include_thoughts?: boolean;
+
+    /**
+     * The thinking budget for the model.
+     */
+    thinking_budget?: number;
+  }
+}
+
+/**
+ * Groq model configuration (OpenAI-compatible).
+ */
+export 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 type of the provider.
+   */
+  provider_type?: 'groq';
+
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
+}
+
+/**
+ * Represents the initial tool rule configuration.
+ */
+export interface InitToolRule {
+  /**
+   * The name of the tool. Must exist in the database for the user's organization.
+   */
+  tool_name: string;
+
+  /**
+   * Optional prefilled arguments for this tool. When present, these values will
+   * override any LLM-provided arguments with the same keys during invocation. Keys
    * must match the tool's parameter names and values must satisfy the tool's JSON
    * schema. Supports partial prefill; non-overlapping parameters are left to the
    * model.
@@ -1360,6 +1239,50 @@ export interface MessageCreate {
   type?: 'message' | null;
 }
 
+export 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 type of the provider.
+   */
+  provider_type?: 'openai';
+
+  /**
+   * The reasoning configuration for the model.
+   */
+  reasoning?: OpenAIModelSettings.Reasoning;
+
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
+}
+
+export namespace OpenAIModelSettings {
+  /**
+   * The reasoning configuration for the model.
+   */
+  export interface Reasoning {
+    /**
+     * The reasoning effort to use when generating text reasoning models
+     */
+    reasoning_effort?: 'minimal' | 'low' | 'medium' | 'high';
+  }
+}
+
 /**
  * A ToolRule that only allows a child tool to be called if the parent has been
  * called.
@@ -1448,6 +1371,66 @@ export interface TextResponseFormat {
   type?: 'text';
 }
 
+/**
+ * Together AI model configuration (OpenAI-compatible).
+ */
+export 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 type of the provider.
+   */
+  provider_type?: 'together';
+
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
+}
+
+/**
+ * xAI model configuration (OpenAI-compatible).
+ */
+export 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 type of the provider.
+   */
+  provider_type?: 'xai';
+
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
+}
+
 export type AgentDeleteResponse = unknown;
 
 export type AgentExportFileResponse = string;
@@ -1615,16 +1598,16 @@ export interface AgentCreateParams {
    * 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
+    | OpenAIModelSettings
+    | AnthropicModelSettings
+    | GoogleAIModelSettings
+    | GoogleVertexModelSettings
+    | AzureModelSettings
+    | XaiModelSettings
+    | GroqModelSettings
+    | DeepseekModelSettings
+    | TogetherModelSettings
+    | BedrockModelSettings
     | null;
 
   /**
@@ -1736,487 +1719,78 @@ export interface AgentCreateParams {
   tools?: Array<string> | null;
 }
 
-export namespace AgentCreateParams {
-  export interface OpenAIModelSettings {
-    /**
-     * The maximum number of tokens the model can generate.
-     */
-    max_output_tokens?: 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'
+  >;
 
-    /**
-     * Whether to enable parallel tool calling.
-     */
-    parallel_tool_calls?: boolean;
+  /**
+   * 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;
+}
 
-    /**
-     * The provider of the model.
-     */
-    provider?: 'openai';
+export interface AgentListParams extends ArrayPageParams {
+  /**
+   * @deprecated Whether to sort agents oldest to newest (True) or newest to oldest
+   * (False, default)
+   */
+  ascending?: boolean;
 
-    /**
-     * The reasoning configuration for the model.
-     */
-    reasoning?: OpenAIModelSettings.Reasoning;
+  /**
+   * Search agents by base template ID
+   */
+  base_template_id?: string | null;
 
-    /**
-     * The response format for the model.
-     */
-    response_format?:
-      | AgentsAPI.TextResponseFormat
-      | AgentsAPI.JsonSchemaResponseFormat
-      | AgentsAPI.JsonObjectResponseFormat
-      | null;
+  /**
+   * Search agents by identifier keys
+   */
+  identifier_keys?: Array<string> | null;
 
-    /**
-     * The temperature of the model.
-     */
-    temperature?: number;
-  }
+  /**
+   * Search agents by identity ID
+   */
+  identity_id?: string | null;
 
-  export namespace OpenAIModelSettings {
-    /**
-     * The reasoning configuration for the model.
-     */
-    export interface Reasoning {
-      /**
-       * The reasoning effort to use when generating text reasoning models
-       */
-      reasoning_effort?: 'minimal' | 'low' | 'medium' | 'high';
-    }
-  }
+  /**
+   * 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'
+  >;
 
-  export interface AnthropicModelSettings {
-    /**
-     * The maximum number of tokens the model can generate.
-     */
-    max_output_tokens?: number;
+  /**
+   * 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;
 
-    /**
-     * 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 namespace AnthropicModelSettings {
-    /**
-     * The thinking configuration for the model.
-     */
-    export 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';
-    }
-  }
-
-  export 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;
-  }
-
-  export namespace GoogleAIModelSettings {
-    /**
-     * The thinking configuration for the model.
-     */
-    export interface ThinkingConfig {
-      /**
-       * Whether to include thoughts in the model's response.
-       */
-      include_thoughts?: boolean;
-
-      /**
-       * The thinking budget for the model.
-       */
-      thinking_budget?: number;
-    }
-  }
-
-  export 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;
-  }
-
-  export namespace GoogleVertexModelSettings {
-    /**
-     * The thinking configuration for the model.
-     */
-    export 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).
-   */
-  export 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).
-   */
-  export 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).
-   */
-  export 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).
-   */
-  export 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).
-   */
-  export 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.
-   */
-  export 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;
+  /**
+   * 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
@@ -2237,731 +1811,334 @@ export interface AgentListParams extends ArrayPageParams {
   /**
    * Search agents by name
    */
-  query_text?: string | null;
-
-  /**
-   * @deprecated Field to sort by. Options: 'created_at' (default),
-   * 'last_run_completion'
-   */
-  sort_by?: string | null;
-
-  /**
-   * List of tags to filter agents by
-   */
-  tags?: Array<string> | null;
-
-  /**
-   * Search agents by template ID
-   */
-  template_id?: string | null;
-}
-
-export interface AgentExportFileParams {
-  /**
-   * @deprecated
-   */
-  max_steps?: number;
-
-  /**
-   * @deprecated If True, exports using the legacy single-agent 'v1' format with
-   * inline tools/blocks. If False, exports using the new multi-entity 'v2' format,
-   * with separate agents, tools, blocks, files, etc.
-   */
-  use_legacy_format?: boolean;
-}
-
-export interface AgentImportFileParams {
-  /**
-   * Body param:
-   */
-  file: Uploadable;
-
-  /**
-   * @deprecated Body param: If set to True, appends "\_copy" to the end of the agent
-   * name.
-   */
-  append_copy_suffix?: boolean;
-
-  /**
-   * Body param: Environment variables as a JSON string to pass to the agent for tool
-   * execution.
-   */
-  env_vars_json?: string | null;
-
-  /**
-   * Body param: Override import with specific embedding handle.
-   */
-  override_embedding_handle?: string | null;
-
-  /**
-   * Body param: If set to True, existing tools can get their source code overwritten
-   * by the uploaded tool definitions. Note that Letta core tools can never be
-   * updated externally.
-   */
-  override_existing_tools?: boolean;
-
-  /**
-   * Body param: If provided, overrides the agent name with this value.
-   */
-  override_name?: string | null;
-
-  /**
-   * Body param: The project ID to associate the uploaded agent with.
-   */
-  project_id?: string | null;
-
-  /**
-   * Body param: If set to True, strips all messages from the agent before importing.
-   */
-  strip_messages?: boolean;
-
-  /**
-   * Header param:
-   */
-  'x-override-embedding-model'?: string;
-}
-
-export interface AgentModifyParams {
-  /**
-   * The base template id of the agent.
-   */
-  base_template_id?: string | null;
-
-  /**
-   * The ids of the blocks used by the agent.
-   */
-  block_ids?: Array<string> | null;
-
-  /**
-   * The context window limit used by the agent.
-   */
-  context_window_limit?: number | null;
-
-  /**
-   * The description of the agent.
-   */
-  description?: string | null;
-
-  /**
-   * The embedding model handle used by the agent (format: provider/model-name).
-   */
-  embedding?: string | null;
-
-  /**
-   * Configuration for embedding model connection and processing parameters.
-   */
-  embedding_config?: ModelsAPI.EmbeddingConfig | null;
-
-  /**
-   * If set to True, memory management will move to a background agent thread.
-   */
-  enable_sleeptime?: boolean | null;
-
-  /**
-   * If set to True, the agent will be hidden.
-   */
-  hidden?: boolean | null;
-
-  /**
-   * The ids of the identities associated with this agent.
-   */
-  identity_ids?: Array<string> | null;
-
-  /**
-   * The timestamp when the agent last completed a run.
-   */
-  last_run_completion?: string | null;
-
-  /**
-   * The duration in milliseconds of the agent's last run.
-   */
-  last_run_duration_ms?: number | null;
-
-  /**
-   * The stop reason from the agent's last run.
-   */
-  last_stop_reason?: RunsAPI.StopReasonType | null;
+  query_text?: string | null;
 
   /**
-   * Configuration for Language Model (LLM) connection and generation parameters.
+   * @deprecated Field to sort by. Options: 'created_at' (default),
+   * 'last_run_completion'
    */
-  llm_config?: ModelsAPI.LlmConfig | null;
+  sort_by?: string | null;
 
   /**
-   * Maximum number of files that can be open at once for this agent. Setting this
-   * too high may exceed the context window, which will break the agent.
+   * List of tags to filter agents by
    */
-  max_files_open?: number | null;
+  tags?: Array<string> | null;
 
   /**
-   * @deprecated Deprecated: Use `model` field to configure max output tokens
-   * instead. The maximum number of tokens to generate, including reasoning step.
+   * Search agents by template ID
    */
-  max_tokens?: number | null;
+  template_id?: string | null;
+}
 
+export interface AgentExportFileParams {
   /**
-   * If set to True, the agent will not remember previous messages (though the agent
-   * will still retain state via core memory blocks and archival/recall memory). Not
-   * recommended unless you have an advanced use case.
+   * @deprecated
    */
-  message_buffer_autoclear?: boolean | null;
+  max_steps?: number;
 
   /**
-   * The ids of the messages in the agent's in-context memory.
+   * @deprecated If True, exports using the legacy single-agent 'v1' format with
+   * inline tools/blocks. If False, exports using the new multi-entity 'v2' format,
+   * with separate agents, tools, blocks, files, etc.
    */
-  message_ids?: Array<string> | null;
+  use_legacy_format?: boolean;
+}
 
+export interface AgentImportFileParams {
   /**
-   * The metadata of the agent.
+   * Body param:
    */
-  metadata?: { [key: string]: unknown } | null;
+  file: Uploadable;
 
   /**
-   * The model handle used by the agent (format: provider/model-name).
+   * @deprecated Body param: If set to True, appends "\_copy" to the end of the agent
+   * name.
    */
-  model?: string | null;
+  append_copy_suffix?: boolean;
 
   /**
-   * The model settings for the agent.
+   * Body param: Environment variables as a JSON string to pass to the agent for tool
+   * execution.
    */
-  model_settings?:
-    | AgentModifyParams.OpenAIModelSettings
-    | AgentModifyParams.AnthropicModelSettings
-    | AgentModifyParams.GoogleAIModelSettings
-    | AgentModifyParams.GoogleVertexModelSettings
-    | AgentModifyParams.AzureModelSettings
-    | AgentModifyParams.XaiModelSettings
-    | AgentModifyParams.GroqModelSettings
-    | AgentModifyParams.DeepseekModelSettings
-    | AgentModifyParams.TogetherModelSettings
-    | AgentModifyParams.BedrockModelSettings
-    | null;
+  env_vars_json?: string | null;
 
   /**
-   * The name of the agent.
+   * Body param: Override import with specific embedding handle.
    */
-  name?: string | null;
+  override_embedding_handle?: string | null;
 
   /**
-   * @deprecated Deprecated: Use `model` field to configure parallel tool calls
-   * instead. If set to True, enables parallel tool calling.
+   * Body param: If set to True, existing tools can get their source code overwritten
+   * by the uploaded tool definitions. Note that Letta core tools can never be
+   * updated externally.
    */
-  parallel_tool_calls?: boolean | null;
+  override_existing_tools?: boolean;
 
   /**
-   * The per-file view window character limit for this agent. Setting this too high
-   * may exceed the context window, which will break the agent.
+   * Body param: If provided, overrides the agent name with this value.
    */
-  per_file_view_window_char_limit?: number | null;
+  override_name?: string | null;
 
   /**
-   * The id of the project the agent belongs to.
+   * Body param: The project ID to associate the uploaded agent with.
    */
   project_id?: string | null;
 
   /**
-   * @deprecated Deprecated: Use `model` field to configure reasoning instead.
-   * Whether to enable reasoning for this agent.
+   * Body param: If set to True, strips all messages from the agent before importing.
    */
-  reasoning?: boolean | null;
+  strip_messages?: boolean;
 
   /**
-   * @deprecated Deprecated: Use `model` field to configure response format instead.
-   * The response format for the agent.
+   * Header param:
    */
-  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+  'x-override-embedding-model'?: string;
+}
 
+export interface AgentModifyParams {
   /**
-   * The environment variables for tool execution specific to this agent.
+   * The base template id of the agent.
    */
-  secrets?: { [key: string]: string } | null;
+  base_template_id?: string | null;
 
   /**
-   * The ids of the sources used by the agent.
+   * The ids of the blocks used by the agent.
    */
-  source_ids?: Array<string> | null;
+  block_ids?: Array<string> | null;
 
   /**
-   * The system prompt used by the agent.
+   * The context window limit used by the agent.
    */
-  system?: string | null;
+  context_window_limit?: number | null;
 
   /**
-   * The tags associated with the agent.
+   * The description of the agent.
    */
-  tags?: Array<string> | null;
+  description?: string | null;
 
   /**
-   * The id of the template the agent belongs to.
+   * The embedding model handle used by the agent (format: provider/model-name).
    */
-  template_id?: string | null;
+  embedding?: string | null;
 
   /**
-   * The timezone of the agent (IANA format).
+   * Configuration for embedding model connection and processing parameters.
    */
-  timezone?: string | null;
+  embedding_config?: ModelsAPI.EmbeddingConfig | null;
 
   /**
-   * Deprecated: use `secrets` field instead
+   * If set to True, memory management will move to a background agent thread.
    */
-  tool_exec_environment_variables?: { [key: string]: string } | null;
+  enable_sleeptime?: boolean | null;
 
   /**
-   * The ids of the tools used by the agent.
+   * If set to True, the agent will be hidden.
    */
-  tool_ids?: Array<string> | null;
+  hidden?: boolean | null;
 
   /**
-   * The tool rules governing the agent.
+   * The ids of the identities associated with this agent.
    */
-  tool_rules?: Array<
-    | ChildToolRule
-    | InitToolRule
-    | TerminalToolRule
-    | ConditionalToolRule
-    | ContinueToolRule
-    | RequiredBeforeExitToolRule
-    | MaxCountPerStepToolRule
-    | ParentToolRule
-    | RequiresApprovalToolRule
-  > | null;
-}
-
-export namespace AgentModifyParams {
-  export 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;
-  }
-
-  export namespace OpenAIModelSettings {
-    /**
-     * The reasoning configuration for the model.
-     */
-    export interface Reasoning {
-      /**
-       * The reasoning effort to use when generating text reasoning models
-       */
-      reasoning_effort?: 'minimal' | 'low' | 'medium' | 'high';
-    }
-  }
-
-  export 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 namespace AnthropicModelSettings {
-    /**
-     * The thinking configuration for the model.
-     */
-    export 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';
-    }
-  }
-
-  export 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;
-  }
-
-  export namespace GoogleAIModelSettings {
-    /**
-     * The thinking configuration for the model.
-     */
-    export interface ThinkingConfig {
-      /**
-       * Whether to include thoughts in the model's response.
-       */
-      include_thoughts?: boolean;
-
-      /**
-       * The thinking budget for the model.
-       */
-      thinking_budget?: number;
-    }
-  }
-
-  export 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;
-  }
-
-  export namespace GoogleVertexModelSettings {
-    /**
-     * The thinking configuration for the model.
-     */
-    export interface ThinkingConfig {
-      /**
-       * Whether to include thoughts in the model's response.
-       */
-      include_thoughts?: boolean;
-
-      /**
-       * The thinking budget for the model.
-       */
-      thinking_budget?: number;
-    }
-  }
+  identity_ids?: Array<string> | null;
 
   /**
-   * Azure OpenAI model configuration (OpenAI-compatible).
+   * The timestamp when the agent last completed a run.
    */
-  export 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;
+  last_run_completion?: string | null;
 
-    /**
-     * The temperature of the model.
-     */
-    temperature?: number;
-  }
+  /**
+   * The duration in milliseconds of the agent's last run.
+   */
+  last_run_duration_ms?: number | null;
 
   /**
-   * xAI model configuration (OpenAI-compatible).
+   * The stop reason from the agent's last run.
    */
-  export 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;
+  last_stop_reason?: RunsAPI.StopReasonType | null;
 
-    /**
-     * The provider of the model.
-     */
-    provider?: 'xai';
+  /**
+   * Configuration for Language Model (LLM) connection and generation parameters.
+   */
+  llm_config?: ModelsAPI.LlmConfig | null;
 
-    /**
-     * The response format for the model.
-     */
-    response_format?:
-      | AgentsAPI.TextResponseFormat
-      | AgentsAPI.JsonSchemaResponseFormat
-      | AgentsAPI.JsonObjectResponseFormat
-      | null;
+  /**
+   * Maximum number of files that can be open at once for this agent. Setting this
+   * too high may exceed the context window, which will break the agent.
+   */
+  max_files_open?: number | null;
 
-    /**
-     * The temperature of the model.
-     */
-    temperature?: number;
-  }
+  /**
+   * @deprecated Deprecated: Use `model` field to configure max output tokens
+   * instead. The maximum number of tokens to generate, including reasoning step.
+   */
+  max_tokens?: number | null;
 
   /**
-   * Groq model configuration (OpenAI-compatible).
+   * If set to True, the agent will not remember previous messages (though the agent
+   * will still retain state via core memory blocks and archival/recall memory). Not
+   * recommended unless you have an advanced use case.
    */
-  export interface GroqModelSettings {
-    /**
-     * The maximum number of tokens the model can generate.
-     */
-    max_output_tokens?: number;
+  message_buffer_autoclear?: boolean | null;
 
-    /**
-     * Whether to enable parallel tool calling.
-     */
-    parallel_tool_calls?: boolean;
+  /**
+   * The ids of the messages in the agent's in-context memory.
+   */
+  message_ids?: Array<string> | null;
 
-    /**
-     * The provider of the model.
-     */
-    provider?: 'groq';
+  /**
+   * The metadata of the agent.
+   */
+  metadata?: { [key: string]: unknown } | null;
 
-    /**
-     * The response format for the model.
-     */
-    response_format?:
-      | AgentsAPI.TextResponseFormat
-      | AgentsAPI.JsonSchemaResponseFormat
-      | AgentsAPI.JsonObjectResponseFormat
-      | null;
+  /**
+   * The model handle used by the agent (format: provider/model-name).
+   */
+  model?: string | null;
 
-    /**
-     * The temperature of the model.
-     */
-    temperature?: number;
-  }
+  /**
+   * The model settings for the agent.
+   */
+  model_settings?:
+    | OpenAIModelSettings
+    | AnthropicModelSettings
+    | GoogleAIModelSettings
+    | GoogleVertexModelSettings
+    | AzureModelSettings
+    | XaiModelSettings
+    | GroqModelSettings
+    | DeepseekModelSettings
+    | TogetherModelSettings
+    | BedrockModelSettings
+    | null;
 
   /**
-   * Deepseek model configuration (OpenAI-compatible).
+   * The name of the agent.
    */
-  export interface DeepseekModelSettings {
-    /**
-     * The maximum number of tokens the model can generate.
-     */
-    max_output_tokens?: number;
+  name?: string | null;
 
-    /**
-     * Whether to enable parallel tool calling.
-     */
-    parallel_tool_calls?: boolean;
+  /**
+   * @deprecated Deprecated: Use `model` field to configure parallel tool calls
+   * instead. If set to True, enables parallel tool calling.
+   */
+  parallel_tool_calls?: boolean | null;
 
-    /**
-     * The provider of the model.
-     */
-    provider?: 'deepseek';
+  /**
+   * The per-file view window character limit for this agent. Setting this too high
+   * may exceed the context window, which will break the agent.
+   */
+  per_file_view_window_char_limit?: number | null;
 
-    /**
-     * The response format for the model.
-     */
-    response_format?:
-      | AgentsAPI.TextResponseFormat
-      | AgentsAPI.JsonSchemaResponseFormat
-      | AgentsAPI.JsonObjectResponseFormat
-      | null;
+  /**
+   * The id of the project the agent belongs to.
+   */
+  project_id?: string | null;
 
-    /**
-     * The temperature of the model.
-     */
-    temperature?: number;
-  }
+  /**
+   * @deprecated Deprecated: Use `model` field to configure reasoning instead.
+   * Whether to enable reasoning for this agent.
+   */
+  reasoning?: boolean | null;
 
   /**
-   * Together AI model configuration (OpenAI-compatible).
+   * @deprecated Deprecated: Use `model` field to configure response format instead.
+   * The response format for the agent.
    */
-  export interface TogetherModelSettings {
-    /**
-     * The maximum number of tokens the model can generate.
-     */
-    max_output_tokens?: number;
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
 
-    /**
-     * Whether to enable parallel tool calling.
-     */
-    parallel_tool_calls?: boolean;
+  /**
+   * The environment variables for tool execution specific to this agent.
+   */
+  secrets?: { [key: string]: string } | null;
 
-    /**
-     * The provider of the model.
-     */
-    provider?: 'together';
+  /**
+   * The ids of the sources used by the agent.
+   */
+  source_ids?: Array<string> | null;
 
-    /**
-     * The response format for the model.
-     */
-    response_format?:
-      | AgentsAPI.TextResponseFormat
-      | AgentsAPI.JsonSchemaResponseFormat
-      | AgentsAPI.JsonObjectResponseFormat
-      | null;
+  /**
+   * The system prompt used by the agent.
+   */
+  system?: string | null;
 
-    /**
-     * The temperature of the model.
-     */
-    temperature?: number;
-  }
+  /**
+   * The tags associated with the agent.
+   */
+  tags?: Array<string> | null;
 
   /**
-   * AWS Bedrock model configuration.
+   * The id of the template the agent belongs to.
    */
-  export interface BedrockModelSettings {
-    /**
-     * The maximum number of tokens the model can generate.
-     */
-    max_output_tokens?: number;
+  template_id?: string | null;
 
-    /**
-     * Whether to enable parallel tool calling.
-     */
-    parallel_tool_calls?: boolean;
+  /**
+   * The timezone of the agent (IANA format).
+   */
+  timezone?: string | null;
 
-    /**
-     * The provider of the model.
-     */
-    provider?: 'bedrock';
+  /**
+   * Deprecated: use `secrets` field instead
+   */
+  tool_exec_environment_variables?: { [key: string]: string } | null;
 
-    /**
-     * The response format for the model.
-     */
-    response_format?:
-      | AgentsAPI.TextResponseFormat
-      | AgentsAPI.JsonSchemaResponseFormat
-      | AgentsAPI.JsonObjectResponseFormat
-      | null;
+  /**
+   * The ids of the tools used by the agent.
+   */
+  tool_ids?: Array<string> | null;
 
-    /**
-     * The temperature of the model.
-     */
-    temperature?: number;
-  }
+  /**
+   * The tool rules governing the agent.
+   */
+  tool_rules?: Array<
+    | ChildToolRule
+    | InitToolRule
+    | TerminalToolRule
+    | ConditionalToolRule
+    | ContinueToolRule
+    | RequiredBeforeExitToolRule
+    | MaxCountPerStepToolRule
+    | ParentToolRule
+    | RequiresApprovalToolRule
+  > | null;
 }
 
+Agents.Messages = Messages;
+Agents.Blocks = Blocks;
 Agents.Tools = Tools;
 Agents.Folders = Folders;
 Agents.Files = Files;
-Agents.Blocks = Blocks;
 Agents.Groups = Groups;
-Agents.Messages = Messages;
+Agents.Archives = Archives;
+Agents.Identities = Identities;
 
 export declare namespace Agents {
   export {
     type AgentEnvironmentVariable as AgentEnvironmentVariable,
     type AgentState as AgentState,
     type AgentType as AgentType,
+    type AnthropicModelSettings as AnthropicModelSettings,
+    type AzureModelSettings as AzureModelSettings,
+    type BedrockModelSettings as BedrockModelSettings,
     type ChildToolRule as ChildToolRule,
     type ConditionalToolRule as ConditionalToolRule,
     type ContinueToolRule as ContinueToolRule,
+    type DeepseekModelSettings as DeepseekModelSettings,
+    type GoogleAIModelSettings as GoogleAIModelSettings,
+    type GoogleVertexModelSettings as GoogleVertexModelSettings,
+    type GroqModelSettings as GroqModelSettings,
     type InitToolRule as InitToolRule,
     type JsonObjectResponseFormat as JsonObjectResponseFormat,
     type JsonSchemaResponseFormat as JsonSchemaResponseFormat,
     type LettaMessageContentUnion as LettaMessageContentUnion,
     type MaxCountPerStepToolRule as MaxCountPerStepToolRule,
     type MessageCreate as MessageCreate,
+    type OpenAIModelSettings as OpenAIModelSettings,
     type ParentToolRule as ParentToolRule,
     type RequiredBeforeExitToolRule as RequiredBeforeExitToolRule,
     type RequiresApprovalToolRule as RequiresApprovalToolRule,
     type TerminalToolRule as TerminalToolRule,
     type TextResponseFormat as TextResponseFormat,
+    type TogetherModelSettings as TogetherModelSettings,
+    type XaiModelSettings as XaiModelSettings,
     type AgentDeleteResponse as AgentDeleteResponse,
     type AgentExportFileResponse as AgentExportFileResponse,
     type AgentImportFileResponse as AgentImportFileResponse,
@@ -2974,61 +2151,20 @@ export declare namespace Agents {
     type AgentModifyParams as AgentModifyParams,
   };
 
-  export {
-    Tools as Tools,
-    type ToolListParams as ToolListParams,
-    type ToolAttachParams as ToolAttachParams,
-    type ToolDetachParams as ToolDetachParams,
-    type ToolUpdateApprovalParams as ToolUpdateApprovalParams,
-  };
-
-  export {
-    Folders as Folders,
-    type FolderListResponse as FolderListResponse,
-    type FolderListResponsesArrayPage as FolderListResponsesArrayPage,
-    type FolderListParams as FolderListParams,
-    type FolderAttachParams as FolderAttachParams,
-    type FolderDetachParams as FolderDetachParams,
-  };
-
-  export {
-    Files as Files,
-    type FileListResponse as FileListResponse,
-    type FileCloseResponse as FileCloseResponse,
-    type FileCloseAllResponse as FileCloseAllResponse,
-    type FileOpenResponse as FileOpenResponse,
-    type FileListResponsesNextFilesPage as FileListResponsesNextFilesPage,
-    type FileListParams as FileListParams,
-    type FileCloseParams as FileCloseParams,
-    type FileOpenParams as FileOpenParams,
-  };
-
-  export {
-    Blocks as Blocks,
-    type Block as Block,
-    type BlockModify as BlockModify,
-    type BlockRetrieveParams as BlockRetrieveParams,
-    type BlockListParams as BlockListParams,
-    type BlockAttachParams as BlockAttachParams,
-    type BlockDetachParams as BlockDetachParams,
-    type BlockModifyParams as BlockModifyParams,
-  };
-
-  export { Groups as Groups, type GroupListParams as GroupListParams };
-
   export {
     Messages as Messages,
     type ApprovalCreate as ApprovalCreate,
     type ApprovalRequestMessage as ApprovalRequestMessage,
     type ApprovalResponseMessage as ApprovalResponseMessage,
+    type ApprovalReturn as ApprovalReturn,
     type AssistantMessage as AssistantMessage,
     type EventMessage as EventMessage,
     type HiddenReasoningMessage as HiddenReasoningMessage,
     type ImageContent as ImageContent,
+    type InternalMessage as InternalMessage,
     type JobStatus as JobStatus,
     type JobType as JobType,
     type LettaAssistantMessageContentUnion as LettaAssistantMessageContentUnion,
-    type LettaMessageUnion as LettaMessageUnion,
     type LettaRequest as LettaRequest,
     type LettaResponse as LettaResponse,
     type LettaStreamingRequest as LettaStreamingRequest,
@@ -3058,7 +2194,7 @@ export declare namespace Agents {
     type UserMessage as UserMessage,
     type MessageCancelResponse as MessageCancelResponse,
     type MessageModifyResponse as MessageModifyResponse,
-    type LettaMessageUnionsArrayPage as LettaMessageUnionsArrayPage,
+    type MessagesArrayPage as MessagesArrayPage,
     type MessageListParams as MessageListParams,
     type MessageCancelParams as MessageCancelParams,
     type MessageModifyParams as MessageModifyParams,
@@ -3069,4 +2205,62 @@ export declare namespace Agents {
     type MessageSendAsyncParams as MessageSendAsyncParams,
     type MessageStreamParams as MessageStreamParams,
   };
+
+  export {
+    Blocks as Blocks,
+    type Block as Block,
+    type BlockModify as BlockModify,
+    type BlockRetrieveParams as BlockRetrieveParams,
+    type BlockListParams as BlockListParams,
+    type BlockAttachParams as BlockAttachParams,
+    type BlockDetachParams as BlockDetachParams,
+    type BlockModifyParams as BlockModifyParams,
+  };
+
+  export {
+    Tools as Tools,
+    type ToolListParams as ToolListParams,
+    type ToolAttachParams as ToolAttachParams,
+    type ToolDetachParams as ToolDetachParams,
+    type ToolUpdateApprovalParams as ToolUpdateApprovalParams,
+  };
+
+  export {
+    Folders as Folders,
+    type FolderListResponse as FolderListResponse,
+    type FolderListResponsesArrayPage as FolderListResponsesArrayPage,
+    type FolderListParams as FolderListParams,
+    type FolderAttachParams as FolderAttachParams,
+    type FolderDetachParams as FolderDetachParams,
+  };
+
+  export {
+    Files as Files,
+    type FileListResponse as FileListResponse,
+    type FileCloseResponse as FileCloseResponse,
+    type FileCloseAllResponse as FileCloseAllResponse,
+    type FileOpenResponse as FileOpenResponse,
+    type FileListResponsesNextFilesPage as FileListResponsesNextFilesPage,
+    type FileListParams as FileListParams,
+    type FileCloseParams as FileCloseParams,
+    type FileOpenParams as FileOpenParams,
+  };
+
+  export { Groups as Groups, type GroupListParams as GroupListParams };
+
+  export {
+    Archives as Archives,
+    type ArchiveAttachResponse as ArchiveAttachResponse,
+    type ArchiveDetachResponse as ArchiveDetachResponse,
+    type ArchiveAttachParams as ArchiveAttachParams,
+    type ArchiveDetachParams as ArchiveDetachParams,
+  };
+
+  export {
+    Identities as Identities,
+    type IdentityAttachResponse as IdentityAttachResponse,
+    type IdentityDetachResponse as IdentityDetachResponse,
+    type IdentityAttachParams as IdentityAttachParams,
+    type IdentityDetachParams as IdentityDetachParams,
+  };
 }