@letta-ai/letta-client 1.0.0-alpha.6 → 1.0.0

package/src/resources/agents/agents.ts

@@ -1,20 +1,27 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as BlocksAPI from '../blocks';
-import * as ModelsAPI from '../models';
-import * as ArchivalMemoryAPI from './archival-memory';
+import * as AgentsAPI from './agents';
+import * as ToolsAPI from '../tools';
+import * as ArchivesAPI from './archives';
 import {
-  ArchivalMemory,
-  ArchivalMemoryCreateParams,
-  ArchivalMemoryCreateResponse,
-  ArchivalMemoryDeleteParams,
-  ArchivalMemoryDeleteResponse,
-  ArchivalMemoryListParams,
-  ArchivalMemoryListResponse,
-  ArchivalMemorySearchParams,
-  ArchivalMemorySearchResponse,
-} from './archival-memory';
+  ArchiveAttachParams,
+  ArchiveAttachResponse,
+  ArchiveDetachParams,
+  ArchiveDetachResponse,
+  Archives,
+} from './archives';
+import * as BlocksAPI from './blocks';
+import {
+  Block,
+  BlockAttachParams,
+  BlockDetachParams,
+  BlockListParams,
+  BlockRetrieveParams,
+  BlockUpdate,
+  BlockUpdateParams,
+  Blocks,
+} from './blocks';
 import * as FilesAPI from './files';
 import {
   FileCloseAllResponse,
@@ -22,51 +29,69 @@ import {
   FileCloseResponse,
   FileListParams,
   FileListResponse,
+  FileListResponsesNextFilesPage,
   FileOpenParams,
   FileOpenResponse,
   Files,
 } from './files';
 import * as FoldersAPI from './folders';
-import { FolderAttachParams, FolderDetachParams, FolderListResponse, Folders } from './folders';
+import {
+  FolderAttachParams,
+  FolderDetachParams,
+  FolderListParams,
+  FolderListResponse,
+  FolderListResponsesArrayPage,
+  Folders,
+} 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,
   LettaRequest,
   LettaResponse,
   LettaStreamingRequest,
+  LettaStreamingResponse,
   LettaUserMessageContentUnion,
   Message,
   MessageCancelParams,
   MessageCancelResponse,
+  MessageCreateAsyncParams,
+  MessageCreateParams,
+  MessageCreateParamsNonStreaming,
+  MessageCreateParamsStreaming,
   MessageListParams,
-  MessageListResponse,
-  MessagePreviewRawPayloadParams,
-  MessagePreviewRawPayloadResponse,
+  MessageResetParams,
   MessageRole,
-  MessageSearchParams,
-  MessageSearchResponse,
-  MessageSendAsyncParams,
-  MessageSendParams,
-  MessageSendStreamParams,
-  MessageSendStreamResponse,
+  MessageStreamParams,
   MessageType,
-  MessageUpdateParams,
-  MessageUpdateResponse,
   Messages,
+  MessagesArrayPage,
   OmittedReasoningContent,
   ReasoningContent,
   ReasoningMessage,
   RedactedReasoningContent,
   Run,
+  SummaryMessage,
   SystemMessage,
   TextContent,
   ToolCall,
@@ -81,22 +106,16 @@ import {
   UpdateUserMessage,
   UserMessage,
 } from './messages';
-import * as SourcesAPI from './sources';
-import { SourceAttachParams, SourceDetachParams, SourceListResponse, Sources } from './sources';
-import * as ToolsAPI from './tools';
-import {
-  ToolAttachParams,
-  ToolDetachParams,
-  ToolListResponse,
-  ToolModifyApprovalParams,
-  Tools,
-} from './tools';
-import * as GroupsAPI from '../groups/groups';
-import * as SourcesSourcesAPI from '../sources/sources';
-import * as ToolsToolsAPI from '../tools/tools';
-import * as CoreMemoryAPI from './core-memory/core-memory';
-import { CoreMemory, CoreMemoryRetrieveVariablesResponse, Memory } from './core-memory/core-memory';
+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 IdentitiesIdentitiesAPI from '../identities/identities';
+import * as ModelsAPI from '../models/models';
+import * as RunsAPI from '../runs/runs';
 import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -104,27 +123,20 @@ import { multipartFormRequestOptions } from '../../internal/uploads';
 import { path } from '../../internal/utils/path';
 
 export class Agents extends APIResource {
-  tools: ToolsAPI.Tools = new ToolsAPI.Tools(this._client);
-  sources: SourcesAPI.Sources = new SourcesAPI.Sources(this._client);
+  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);
-  coreMemory: CoreMemoryAPI.CoreMemory = new CoreMemoryAPI.CoreMemory(this._client);
-  archivalMemory: ArchivalMemoryAPI.ArchivalMemory = new ArchivalMemoryAPI.ArchivalMemory(this._client);
-  messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
+  groups: GroupsAPI.Groups = new GroupsAPI.Groups(this._client);
+  archives: ArchivesAPI.Archives = new ArchivesAPI.Archives(this._client);
+  identities: IdentitiesAPI.Identities = new IdentitiesAPI.Identities(this._client);
 
   /**
    * Create an agent.
    */
-  create(params: AgentCreateParams, options?: RequestOptions): APIPromise<AgentState> {
-    const { 'X-Project': xProject, ...body } = params;
-    return this._client.post('/v1/agents/', {
-      body,
-      ...options,
-      headers: buildHeaders([
-        { ...(xProject != null ? { 'X-Project': xProject } : undefined) },
-        options?.headers,
-      ]),
-    });
+  create(body: AgentCreateParams, options?: RequestOptions): APIPromise<AgentState> {
+    return this._client.post('/v1/agents/', { body, ...options });
   }
 
   /**
@@ -151,8 +163,8 @@ export class Agents extends APIResource {
   list(
     query: AgentListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<AgentListResponse> {
-    return this._client.get('/v1/agents/', { query, ...options });
+  ): PagePromise<AgentStatesArrayPage, AgentState> {
+    return this._client.getAPIList('/v1/agents/', ArrayPage<AgentState>, { query, ...options });
   }
 
   /**
@@ -162,26 +174,13 @@ export class Agents extends APIResource {
     return this._client.delete(path`/v1/agents/${agentID}`, options);
   }
 
-  /**
-   * Get the total number of agents.
-   */
-  count(options?: RequestOptions): APIPromise<AgentCountResponse> {
-    return this._client.get('/v1/agents/count', options);
-  }
-
   /**
    * Export the serialized JSON representation of an agent, formatted with
    * indentation.
-   *
-   * Supports two export formats:
-   *
-   * - Legacy format (use_legacy_format=true): Single agent with inline tools/blocks
-   * - New format (default): Multi-entity format with separate agents, tools, blocks,
-   *   files, etc.
    */
-  export(
+  exportFile(
     agentID: string,
-    query: AgentExportParams | null | undefined = {},
+    query: AgentExportFileParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<string> {
     return this._client.get(path`/v1/agents/${agentID}/export`, { query, ...options });
@@ -191,7 +190,7 @@ export class Agents extends APIResource {
    * Import a serialized agent file and recreate the agent(s) in the system. Returns
    * the IDs of all imported agents.
    */
-  import(params: AgentImportParams, options?: RequestOptions): APIPromise<AgentImportResponse> {
+  importFile(params: AgentImportFileParams, options?: RequestOptions): APIPromise<AgentImportFileResponse> {
     const { 'x-override-embedding-model': xOverrideEmbeddingModel, ...body } = params;
     return this._client.post(
       '/v1/agents/import',
@@ -212,78 +211,10 @@ export class Agents extends APIResource {
       ),
     );
   }
-
-  /**
-   * Lists the groups for an agent
-   */
-  listGroups(
-    agentID: string,
-    query: AgentListGroupsParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<AgentListGroupsResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/groups`, { query, ...options });
-  }
-
-  /**
-   * Migrate an agent to a new versioned agent template. This will only work for
-   * "classic" and non-multiagent agent templates.
-   */
-  migrate(
-    agentID: string,
-    body: AgentMigrateParams,
-    options?: RequestOptions,
-  ): APIPromise<AgentMigrateResponse> {
-    return this._client.post(path`/v1/agents/${agentID}/migrate`, { body, ...options });
-  }
-
-  /**
-   * Resets the messages for an agent
-   */
-  resetMessages(
-    agentID: string,
-    params: AgentResetMessagesParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<AgentState> {
-    const { add_default_initial_messages } = params ?? {};
-    return this._client.patch(path`/v1/agents/${agentID}/reset-messages`, {
-      query: { add_default_initial_messages },
-      ...options,
-    });
-  }
-
-  /**
-   * Retrieve the context window of a specific agent.
-   */
-  retrieveContext(agentID: string, options?: RequestOptions): APIPromise<AgentRetrieveContextResponse> {
-    return this._client.get(path`/v1/agents/${agentID}/context`, options);
-  }
-
-  /**
-   * Search deployed agents
-   */
-  search(
-    body: AgentSearchParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<AgentSearchResponse> {
-    return this._client.post('/v1/agents/search', { body, ...options });
-  }
-
-  /**
-   * Summarize an agent's conversation history to a target message length.
-   *
-   * This endpoint summarizes the current message history for a given agent,
-   * truncating and compressing it down to the specified `max_message_length`.
-   */
-  summarize(agentID: string, params: AgentSummarizeParams, options?: RequestOptions): APIPromise<void> {
-    const { max_message_length } = params;
-    return this._client.post(path`/v1/agents/${agentID}/summarize`, {
-      query: { max_message_length },
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
 }
 
+export type AgentStatesArrayPage = ArrayPage<AgentState>;
+
 export interface AgentEnvironmentVariable {
   /**
    * The ID of the agent this environment variable belongs to.
@@ -329,22 +260,17 @@ export interface AgentEnvironmentVariable {
    * The timestamp when the object was last updated.
    */
   updated_at?: string | null;
+
+  /**
+   * Encrypted secret value (stored as encrypted string)
+   */
+  value_enc?: string | null;
 }
 
 /**
  * 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 {
   /**
@@ -358,19 +284,27 @@ export interface AgentState {
   agent_type: AgentType;
 
   /**
-   * The embedding configuration used by the agent.
+   * The memory blocks used by the agent.
+   */
+  blocks: Array<BlocksAPI.Block>;
+
+  /**
+   * @deprecated Deprecated: Use `embedding` field instead. The embedding
+   * configuration used by the agent.
    */
   embedding_config: ModelsAPI.EmbeddingConfig;
 
   /**
-   * The LLM configuration used by the agent.
+   * @deprecated Deprecated: Use `model` field instead. The LLM configuration used by
+   * the agent.
    */
   llm_config: ModelsAPI.LlmConfig;
 
   /**
-   * The in-context memory of the agent.
+   * @deprecated Deprecated: Use `blocks` field instead. The in-context memory of the
+   * agent.
    */
-  memory: CoreMemoryAPI.Memory;
+  memory: AgentState.Memory;
 
   /**
    * The name of the agent.
@@ -378,9 +312,10 @@ export interface AgentState {
   name: string;
 
   /**
-   * The sources used by the agent.
+   * @deprecated Deprecated: Use `folders` field instead. The sources used by the
+   * agent.
    */
-  sources: Array<SourcesSourcesAPI.Source>;
+  sources: Array<AgentState.Source>;
 
   /**
    * The system prompt used by the agent.
@@ -395,7 +330,7 @@ export interface AgentState {
   /**
    * The tools used by the agent.
    */
-  tools: Array<ToolsToolsAPI.Tool>;
+  tools: Array<ToolsAPI.Tool>;
 
   /**
    * The base template id of the agent.
@@ -422,6 +357,11 @@ export interface AgentState {
    */
   description?: string | null;
 
+  /**
+   * The embedding model handle used by the agent (format: provider/model-name).
+   */
+  embedding?: string | null;
+
   /**
    * If set to True, memory management will move to a background agent thread.
    */
@@ -438,7 +378,13 @@ export interface AgentState {
   hidden?: boolean | null;
 
   /**
-   * The ids of the identities associated with this agent.
+   * The identities associated with this agent.
+   */
+  identities?: Array<IdentitiesIdentitiesAPI.Identity>;
+
+  /**
+   * @deprecated Deprecated: Use `identities` field instead. The ids of the
+   * identities associated with this agent.
    */
   identity_ids?: Array<string>;
 
@@ -452,11 +398,21 @@ export interface AgentState {
    */
   last_run_duration_ms?: number | null;
 
+  /**
+   * The stop reason from the agent's last run.
+   */
+  last_stop_reason?: RunsAPI.StopReasonType | null;
+
   /**
    * The id of the user that made this object.
    */
   last_updated_by_id?: string | null;
 
+  /**
+   * The multi-agent group that this agent manages
+   */
+  managed_group?: GroupsGroupsAPI.Group | 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.
@@ -481,9 +437,31 @@ export interface AgentState {
   metadata?: { [key: string]: unknown } | null;
 
   /**
-   * The multi-agent group that this agent manages
+   * The model handle used by the agent (format: provider/model-name).
    */
-  multi_agent_group?: GroupsAPI.Group | null;
+  model?: string | null;
+
+  /**
+   * The model settings used by the agent.
+   */
+  model_settings?:
+    | OpenAIModelSettings
+    | AnthropicModelSettings
+    | GoogleAIModelSettings
+    | GoogleVertexModelSettings
+    | AzureModelSettings
+    | XaiModelSettings
+    | GroqModelSettings
+    | DeepseekModelSettings
+    | TogetherModelSettings
+    | BedrockModelSettings
+    | null;
+
+  /**
+   * @deprecated Deprecated: Use `managed_group` field instead. The multi-agent group
+   * that this agent manages.
+   */
+  multi_agent_group?: GroupsGroupsAPI.Group | null;
 
   /**
    * The per-file view window character limit for this agent. Setting this too high
@@ -497,7 +475,7 @@ export interface AgentState {
   project_id?: string | null;
 
   /**
-   * The response format used by the agent when returning from `send_message`.
+   * The response format used by the agent
    */
   response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
 
@@ -542,12 +520,218 @@ export interface AgentState {
   updated_at?: string | null;
 }
 
+export namespace AgentState {
+  /**
+   * @deprecated Deprecated: Use `blocks` field instead. The in-context memory of the
+   * agent.
+   */
+  export interface Memory {
+    /**
+     * Memory blocks contained in the agent's in-context memory
+     */
+    blocks: Array<BlocksAPI.Block>;
+
+    /**
+     * Agent type controlling prompt rendering.
+     */
+    agent_type?: AgentsAPI.AgentType | (string & {}) | null;
+
+    /**
+     * Special blocks representing the agent's in-context memory of an attached file
+     */
+    file_blocks?: Array<Memory.FileBlock>;
+
+    /**
+     * Deprecated. Ignored for performance.
+     */
+    prompt_template?: string;
+  }
+
+  export namespace Memory {
+    export interface FileBlock {
+      /**
+       * Unique identifier of the file.
+       */
+      file_id: string;
+
+      /**
+       * True if the agent currently has the file open.
+       */
+      is_open: boolean;
+
+      /**
+       * @deprecated Deprecated: Use `folder_id` field instead. Unique identifier of the
+       * source.
+       */
+      source_id: string;
+
+      /**
+       * Value of the block.
+       */
+      value: string;
+
+      /**
+       * The human-friendly ID of the Block
+       */
+      id?: string;
+
+      /**
+       * The base template id of the block.
+       */
+      base_template_id?: string | null;
+
+      /**
+       * The id of the user that made this Block.
+       */
+      created_by_id?: string | null;
+
+      /**
+       * The id of the deployment.
+       */
+      deployment_id?: string | null;
+
+      /**
+       * Description of the block.
+       */
+      description?: string | null;
+
+      /**
+       * The id of the entity within the template.
+       */
+      entity_id?: string | null;
+
+      /**
+       * If set to True, the block will be hidden.
+       */
+      hidden?: boolean | null;
+
+      /**
+       * Whether the block is a template (e.g. saved human/persona options).
+       */
+      is_template?: boolean;
+
+      /**
+       * Label of the block (e.g. 'human', 'persona') in the context window.
+       */
+      label?: string | null;
+
+      /**
+       * UTC timestamp of the agent’s most recent access to this file. Any operations
+       * from the open, close, or search tools will update this field.
+       */
+      last_accessed_at?: string | null;
+
+      /**
+       * The id of the user that last updated this Block.
+       */
+      last_updated_by_id?: string | null;
+
+      /**
+       * Character limit of the block.
+       */
+      limit?: number;
+
+      /**
+       * Metadata of the block.
+       */
+      metadata?: { [key: string]: unknown } | null;
+
+      /**
+       * Preserve the block on template migration.
+       */
+      preserve_on_migration?: boolean | null;
+
+      /**
+       * The associated project id.
+       */
+      project_id?: string | null;
+
+      /**
+       * Whether the agent has read-only access to the block.
+       */
+      read_only?: boolean;
+
+      /**
+       * The id of the template.
+       */
+      template_id?: string | null;
+
+      /**
+       * Name of the block if it is a template.
+       */
+      template_name?: string | null;
+    }
+  }
+
+  /**
+   * (Deprecated: Use Folder) Representation of a source, which is a collection of
+   * files and passages.
+   */
+  export interface Source {
+    /**
+     * The human-friendly ID of the Source
+     */
+    id: string;
+
+    /**
+     * The embedding configuration used by the source.
+     */
+    embedding_config: ModelsAPI.EmbeddingConfig;
+
+    /**
+     * The name of the source.
+     */
+    name: string;
+
+    /**
+     * The timestamp when the source was created.
+     */
+    created_at?: string | null;
+
+    /**
+     * The id of the user that made this Tool.
+     */
+    created_by_id?: string | null;
+
+    /**
+     * The description of the source.
+     */
+    description?: string | null;
+
+    /**
+     * Instructions for how to use the source.
+     */
+    instructions?: string | null;
+
+    /**
+     * The id of the user that made this Tool.
+     */
+    last_updated_by_id?: string | null;
+
+    /**
+     * Metadata associated with the source.
+     */
+    metadata?: { [key: string]: unknown } | null;
+
+    /**
+     * The timestamp when the source was last updated.
+     */
+    updated_at?: string | null;
+
+    /**
+     * The vector database provider used for this source's passages
+     */
+    vector_db_provider?: ArchivesArchivesAPI.VectorDBProvider;
+  }
+}
+
 /**
  * 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'
@@ -555,6 +739,115 @@ export type AgentType =
   | 'voice_convo_agent'
   | 'voice_sleeptime_agent';
 
+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 type of the provider.
+   */
+  provider_type?: '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';
+  }
+}
+
+/**
+ * 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 type of the provider.
+   */
+  provider_type?: 'azure';
+
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | 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 type of the provider.
+   */
+  provider_type?: 'bedrock';
+
+  /**
+   * The response format for the model.
+   */
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
+  /**
+   * The temperature of the model.
+   */
+  temperature?: number;
+}
+
 /**
  * A ToolRule represents a tool that can be invoked by the agent.
  */
@@ -569,6 +862,12 @@ export interface ChildToolRule {
    */
   tool_name: string;
 
+  /**
+   * Optional list of typed child argument overrides. Each node must reference a
+   * child in 'children'.
+   */
+  child_arg_nodes?: Array<ChildToolRule.ChildArgNode> | null;
+
   /**
    * Optional template string (ignored).
    */
@@ -577,6 +876,28 @@ export interface ChildToolRule {
   type?: 'constrain_child_tools';
 }
 
+export namespace ChildToolRule {
+  /**
+   * Typed child override for prefilled arguments.
+   *
+   * When used in a ChildToolRule, if this child is selected next, its `args` will be
+   * applied as prefilled arguments (overriding overlapping LLM-provided values).
+   */
+  export interface ChildArgNode {
+    /**
+     * The name of the child tool to invoke next.
+     */
+    name: string;
+
+    /**
+     * Optional prefilled arguments for this child tool. 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.
+     */
+    args?: { [key: string]: unknown } | null;
+  }
+}
+
 /**
  * A ToolRule that conditionally maps to different child tools based on the output.
  */
@@ -627,6 +948,164 @@ export interface ContinueToolRule {
   type?: 'continue_loop';
 }
 
+/**
+ * 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 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.
  */
@@ -636,6 +1115,15 @@ export interface InitToolRule {
    */
   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.
+   */
+  args?: { [key: string]: unknown } | null;
+
   /**
    * Optional template string (ignored). Rendering uses fast built-in formatting for
    * performance.
@@ -670,6 +1158,9 @@ export interface JsonSchemaResponseFormat {
   type?: 'json_schema';
 }
 
+/**
+ * Sent via the Anthropic Messages API
+ */
 export type LettaMessageContentUnion =
   | MessagesAPI.TextContent
   | MessagesAPI.ImageContent
@@ -748,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?: 'none' | 'minimal' | 'low' | 'medium' | 'high';
+  }
+}
+
 /**
  * A ToolRule that only allows a child tool to be called if the parent has been
  * called.
@@ -808,411 +1343,374 @@ export interface RequiresApprovalToolRule {
   type?: 'requires_approval';
 }
 
-/**
- * Represents a terminal tool rule configuration where if this tool gets called, it
- * must end the agent loop.
- */
-export interface TerminalToolRule {
-  /**
-   * The name of the tool. Must exist in the database for the user's organization.
-   */
-  tool_name: string;
-
-  /**
-   * Optional template string (ignored).
-   */
-  prompt_template?: string | null;
-
-  type?: 'exit_loop';
-}
-
-/**
- * Response format for plain text responses.
- */
-export interface TextResponseFormat {
-  /**
-   * The type of the response format.
-   */
-  type?: 'text';
-}
-
-export type AgentListResponse = Array<AgentState>;
-
-export type AgentDeleteResponse = unknown;
-
-export type AgentCountResponse = number;
-
-export type AgentExportResponse = string;
-
-/**
- * Response model for imported agents
- */
-export interface AgentImportResponse {
-  /**
-   * List of IDs of the imported agents
-   */
-  agent_ids: Array<string>;
-}
-
-export type AgentListGroupsResponse = Array<GroupsAPI.Group>;
-
-export interface AgentMigrateResponse {
-  success: true;
-}
-
-/**
- * Overview of the context window, including the number of messages and tokens.
- */
-export interface AgentRetrieveContextResponse {
-  /**
-   * The current number of tokens in the context window.
-   */
-  context_window_size_current: number;
-
-  /**
-   * The maximum amount of tokens the context window can hold.
-   */
-  context_window_size_max: number;
-
-  /**
-   * The content of the core memory.
-   */
-  core_memory: string;
-
-  /**
-   * The metadata summary of the external memory sources (archival + recall
-   * metadata).
-   */
-  external_memory_summary: string;
-
+/**
+ * Represents a terminal tool rule configuration where if this tool gets called, it
+ * must end the agent loop.
+ */
+export interface TerminalToolRule {
   /**
-   * The content of the functions definitions.
+   * The name of the tool. Must exist in the database for the user's organization.
    */
-  functions_definitions: Array<AgentRetrieveContextResponse.FunctionsDefinition> | null;
+  tool_name: string;
 
   /**
-   * The messages in the context window.
+   * Optional template string (ignored).
    */
-  messages: Array<MessagesAPI.Message>;
+  prompt_template?: string | null;
+
+  type?: 'exit_loop';
+}
 
+/**
+ * Response format for plain text responses.
+ */
+export interface TextResponseFormat {
   /**
-   * The number of messages in the archival memory.
+   * The type of the response format.
    */
-  num_archival_memory: number;
+  type?: 'text';
+}
 
+/**
+ * Together AI model configuration (OpenAI-compatible).
+ */
+export interface TogetherModelSettings {
   /**
-   * The number of messages in the context window.
+   * The maximum number of tokens the model can generate.
    */
-  num_messages: number;
+  max_output_tokens?: number;
 
   /**
-   * The number of messages in the recall memory.
+   * Whether to enable parallel tool calling.
    */
-  num_recall_memory: number;
+  parallel_tool_calls?: boolean;
 
   /**
-   * The number of tokens in the core memory.
+   * The type of the provider.
    */
-  num_tokens_core_memory: number;
+  provider_type?: 'together';
 
   /**
-   * The number of tokens in the external memory summary (archival + recall
-   * metadata).
+   * The response format for the model.
    */
-  num_tokens_external_memory_summary: number;
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
 
   /**
-   * The number of tokens in the functions definitions.
+   * The temperature of the model.
    */
-  num_tokens_functions_definitions: number;
+  temperature?: number;
+}
 
+/**
+ * xAI model configuration (OpenAI-compatible).
+ */
+export interface XaiModelSettings {
   /**
-   * The number of tokens in the messages list.
+   * The maximum number of tokens the model can generate.
    */
-  num_tokens_messages: number;
+  max_output_tokens?: number;
 
   /**
-   * The number of tokens in the summary memory.
+   * Whether to enable parallel tool calling.
    */
-  num_tokens_summary_memory: number;
+  parallel_tool_calls?: boolean;
 
   /**
-   * The number of tokens in the system prompt.
+   * The type of the provider.
    */
-  num_tokens_system: number;
+  provider_type?: 'xai';
 
   /**
-   * The content of the system prompt.
+   * The response format for the model.
    */
-  system_prompt: string;
+  response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
 
   /**
-   * The content of the summary memory.
+   * The temperature of the model.
    */
-  summary_memory?: string | null;
+  temperature?: number;
 }
 
-export namespace AgentRetrieveContextResponse {
-  export interface FunctionsDefinition {
-    function: FunctionsDefinition.Function;
-
-    type: 'function';
-
-    [k: string]: unknown;
-  }
-
-  export namespace FunctionsDefinition {
-    export interface Function {
-      name: string;
-
-      description?: string | null;
-
-      parameters?: { [key: string]: unknown } | null;
-
-      strict?: boolean | null;
-
-      [k: string]: unknown;
-    }
-  }
-}
+export type AgentDeleteResponse = unknown;
 
-export interface AgentSearchResponse {
-  agents: Array<AgentState>;
+export type AgentExportFileResponse = string;
 
-  nextCursor?: string | null;
+/**
+ * Response model for imported agents
+ */
+export interface AgentImportFileResponse {
+  /**
+   * List of IDs of the imported agents
+   */
+  agent_ids: Array<string>;
 }
 
 export interface AgentCreateParams {
   /**
-   * Body param: The type of agent.
+   * The type of agent.
    */
   agent_type?: AgentType;
 
   /**
-   * Body param: The base template id of the agent.
+   * @deprecated Deprecated: No longer used. The base template id of the agent.
    */
   base_template_id?: string | null;
 
   /**
-   * Body param: The ids of the blocks used by the agent.
+   * The ids of the blocks used by the agent.
    */
   block_ids?: Array<string> | null;
 
   /**
-   * Body param: The context window limit used by the agent.
+   * The context window limit used by the agent.
    */
   context_window_limit?: number | null;
 
   /**
-   * Body param: The description of the agent.
+   * The description of the agent.
    */
   description?: string | null;
 
   /**
-   * Body param: 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 | null;
 
   /**
-   * Body param: The embedding chunk size used by the agent.
+   * @deprecated Deprecated: No longer used. The embedding chunk size used by the
+   * agent.
    */
   embedding_chunk_size?: number | null;
 
   /**
-   * Body param: Configuration for embedding model connection and processing
-   * parameters.
+   * Configuration for embedding model connection and processing parameters.
    */
   embedding_config?: ModelsAPI.EmbeddingConfig | null;
 
   /**
-   * Body param: Whether to enable internal extended thinking step for a reasoner
-   * model.
+   * @deprecated Deprecated: Use `model` field to configure reasoning instead.
+   * Whether to enable internal extended thinking step for a reasoner model.
    */
   enable_reasoner?: boolean | null;
 
   /**
-   * Body param: If set to True, memory management will move to a background agent
-   * thread.
+   * If set to True, memory management will move to a background agent thread.
    */
   enable_sleeptime?: boolean | null;
 
   /**
-   * Body param: The template id used to configure the agent
+   * The ids of the folders used by the agent.
+   */
+  folder_ids?: Array<string> | null;
+
+  /**
+   * @deprecated Deprecated: please use the 'create agents from a template' endpoint
+   * instead.
    */
   from_template?: string | null;
 
   /**
-   * Body param: If set to True, the agent will be hidden.
+   * @deprecated Deprecated: No longer used. If set to True, the agent will be
+   * hidden.
    */
   hidden?: boolean | null;
 
   /**
-   * Body param: The ids of the identities associated with this agent.
+   * The ids of the identities associated with this agent.
    */
   identity_ids?: Array<string> | null;
 
   /**
-   * Body param: If true, attaches the Letta base tool rules (e.g. deny all tools not
-   * explicitly allowed).
+   * If true, attaches the Letta base tool rules (e.g. deny all tools not explicitly
+   * allowed).
    */
   include_base_tool_rules?: boolean | null;
 
   /**
-   * Body param: If true, attaches the Letta core tools (e.g. core_memory related
-   * functions).
+   * If true, attaches the Letta core tools (e.g. core_memory related functions).
    */
   include_base_tools?: boolean;
 
   /**
-   * Body param: If true, automatically creates and attaches a default data source
+   * @deprecated If true, automatically creates and attaches a default data source
    * for this agent.
    */
   include_default_source?: boolean;
 
   /**
-   * Body param: If true, attaches the Letta multi-agent tools (e.g. sending a
-   * message to another agent).
+   * If true, attaches the Letta multi-agent tools (e.g. sending a message to another
+   * agent).
    */
   include_multi_agent_tools?: boolean;
 
   /**
-   * Body param: The initial set of messages to put in the agent's in-context memory.
+   * The initial set of messages to put in the agent's in-context memory.
    */
   initial_message_sequence?: Array<MessageCreate> | null;
 
   /**
-   * Body param: Configuration for Language Model (LLM) connection and generation
-   * parameters.
+   * Configuration for Language Model (LLM) connection and generation parameters.
+   *
+   * .. deprecated:: LLMConfig is deprecated and should not be used as an input or
+   * return type in API calls. Use the schemas in letta.schemas.model (ModelSettings,
+   * OpenAIModelSettings, etc.) instead. For conversion, use the \_to_model() method
+   * or Model.\_from_llm_config() method.
    */
   llm_config?: ModelsAPI.LlmConfig | null;
 
   /**
-   * Body param: 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.
+   * 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;
 
   /**
-   * Body param: The maximum number of tokens to generate for reasoning step. If not
-   * set, the model will use its default value.
+   * @deprecated Deprecated: Use `model` field to configure reasoning tokens instead.
+   * The maximum number of tokens to generate for reasoning step.
    */
   max_reasoning_tokens?: number | null;
 
   /**
-   * Body param: The maximum number of tokens to generate, including reasoning step.
-   * If not set, the model will use its default value.
+   * @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;
 
   /**
-   * Body param: The blocks to create in the agent's in-context memory.
+   * The blocks to create in the agent's in-context memory.
    */
-  memory_blocks?: Array<BlocksAPI.CreateBlock> | null;
+  memory_blocks?: Array<BlocksBlocksAPI.CreateBlock> | null;
 
   /**
-   * Body param: The variables that should be set for the agent.
+   * @deprecated Deprecated: Only relevant for creating agents from a template. Use
+   * the 'create agents from a template' endpoint instead.
    */
   memory_variables?: { [key: string]: string } | null;
 
   /**
-   * Body param: 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.
+   * 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.
    */
   message_buffer_autoclear?: boolean;
 
   /**
-   * Body param: The metadata of the agent.
+   * The metadata of the agent.
    */
   metadata?: { [key: string]: unknown } | null;
 
   /**
-   * Body param: The LLM configuration handle used by the agent, specified in the
-   * format provider/model-name, as an alternative to specifying llm_config.
+   * The model handle for the agent to use (format: provider/model-name).
    */
   model?: string | null;
 
   /**
-   * Body param: The name of the agent.
+   * The model settings for the agent.
+   */
+  model_settings?:
+    | OpenAIModelSettings
+    | AnthropicModelSettings
+    | GoogleAIModelSettings
+    | GoogleVertexModelSettings
+    | AzureModelSettings
+    | XaiModelSettings
+    | GroqModelSettings
+    | DeepseekModelSettings
+    | TogetherModelSettings
+    | BedrockModelSettings
+    | null;
+
+  /**
+   * The name of the agent.
    */
   name?: string;
 
   /**
-   * Body param: The per-file view window character limit for this agent. Setting
-   * this too high may exceed the context window, which will break the agent.
+   * @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 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;
 
   /**
-   * @deprecated Body param: Deprecated: Project should now be passed via the
-   * X-Project header instead of in the request body. If using the sdk, this can be
-   * done via the new x_project field below.
+   * @deprecated Deprecated: Project should now be passed via the X-Project header
+   * instead of in the request body. If using the SDK, this can be done via the
+   * x_project parameter.
    */
   project?: string | null;
 
   /**
-   * Body param: The id of the project the agent belongs to.
+   * @deprecated Deprecated: No longer used. The id of the project the agent belongs
+   * to.
    */
   project_id?: string | null;
 
   /**
-   * Body param: Whether to enable reasoning for this agent.
+   * @deprecated Deprecated: Use `model` field to configure reasoning instead.
+   * Whether to enable reasoning for this agent.
    */
   reasoning?: boolean | null;
 
   /**
-   * Body param: The response format for the agent.
+   * The response format for the agent.
    */
   response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
 
   /**
-   * Body param: The environment variables for tool execution specific to this agent.
+   * The environment variables for tool execution specific to this agent.
    */
   secrets?: { [key: string]: string } | null;
 
   /**
-   * Body param: The ids of the sources used by the agent.
+   * @deprecated Deprecated: Use `folder_ids` field instead. The ids of the sources
+   * used by the agent.
    */
   source_ids?: Array<string> | null;
 
   /**
-   * Body param: The system prompt used by the agent.
+   * The system prompt used by the agent.
    */
   system?: string | null;
 
   /**
-   * Body param: The tags associated with the agent.
+   * The tags associated with the agent.
    */
   tags?: Array<string> | null;
 
   /**
-   * Body param: Whether the agent is a template
+   * @deprecated Deprecated: No longer used.
    */
   template?: boolean;
 
   /**
-   * Body param: The id of the template the agent belongs to.
+   * @deprecated Deprecated: No longer used. The id of the template the agent belongs
+   * to.
    */
   template_id?: string | null;
 
   /**
-   * Body param: The timezone of the agent (IANA format).
+   * The timezone of the agent (IANA format).
    */
   timezone?: string | null;
 
   /**
-   * Body param: Deprecated: use `secrets` field instead.
+   * @deprecated Deprecated: Use `secrets` field instead. Environment variables for
+   * tool execution.
    */
   tool_exec_environment_variables?: { [key: string]: string } | null;
 
   /**
-   * Body param: The ids of the tools used by the agent.
+   * The ids of the tools used by the agent.
    */
   tool_ids?: Array<string> | null;
 
   /**
-   * Body param: The tool rules governing the agent.
+   * The tool rules governing the agent.
    */
   tool_rules?: Array<
     | ChildToolRule
@@ -1227,21 +1725,31 @@ export interface AgentCreateParams {
   > | null;
 
   /**
-   * Body param: The tools used by the agent.
+   * The tools used by the agent.
    */
   tools?: Array<string> | null;
-
-  /**
-   * Header param: The project slug to associate with the agent (cloud only).
-   */
-  'X-Project'?: string;
 }
 
 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 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;
 }
@@ -1257,14 +1765,18 @@ export interface AgentUpdateParams {
    */
   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 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 | null;
 
@@ -1278,6 +1790,11 @@ export interface AgentUpdateParams {
    */
   enable_sleeptime?: boolean | null;
 
+  /**
+   * The ids of the folders used by the agent.
+   */
+  folder_ids?: Array<string> | null;
+
   /**
    * If set to True, the agent will be hidden.
    */
@@ -1298,8 +1815,18 @@ export interface AgentUpdateParams {
    */
   last_run_duration_ms?: number | null;
 
+  /**
+   * The stop reason from the agent's last run.
+   */
+  last_stop_reason?: RunsAPI.StopReasonType | null;
+
   /**
    * Configuration for Language Model (LLM) connection and generation parameters.
+   *
+   * .. deprecated:: LLMConfig is deprecated and should not be used as an input or
+   * return type in API calls. Use the schemas in letta.schemas.model (ModelSettings,
+   * OpenAIModelSettings, etc.) instead. For conversion, use the \_to_model() method
+   * or Model.\_from_llm_config() method.
    */
   llm_config?: ModelsAPI.LlmConfig | null;
 
@@ -1309,6 +1836,12 @@ export interface AgentUpdateParams {
    */
   max_files_open?: number | null;
 
+  /**
+   * @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;
+
   /**
    * 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
@@ -1327,16 +1860,37 @@ export interface AgentUpdateParams {
   metadata?: { [key: string]: unknown } | null;
 
   /**
-   * The LLM configuration handle used by the agent, specified in the format
-   * provider/model-name, as an alternative to specifying llm_config.
+   * The model handle used by the agent (format: provider/model-name).
    */
   model?: string | null;
 
+  /**
+   * The model settings for the agent.
+   */
+  model_settings?:
+    | OpenAIModelSettings
+    | AnthropicModelSettings
+    | GoogleAIModelSettings
+    | GoogleVertexModelSettings
+    | AzureModelSettings
+    | XaiModelSettings
+    | GroqModelSettings
+    | DeepseekModelSettings
+    | TogetherModelSettings
+    | BedrockModelSettings
+    | null;
+
   /**
    * The name of the agent.
    */
   name?: string | null;
 
+  /**
+   * @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 per-file view window character limit for this agent. Setting this too high
    * may exceed the context window, which will break the agent.
@@ -1349,11 +1903,13 @@ export interface AgentUpdateParams {
   project_id?: string | null;
 
   /**
+   * @deprecated Deprecated: Use `model` field to configure reasoning instead.
    * Whether to enable reasoning for this agent.
    */
   reasoning?: boolean | null;
 
   /**
+   * @deprecated Deprecated: Use `model` field to configure response format instead.
    * The response format for the agent.
    */
   response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
@@ -1364,7 +1920,8 @@ export interface AgentUpdateParams {
   secrets?: { [key: string]: string } | null;
 
   /**
-   * The ids of the sources used by the agent.
+   * @deprecated Deprecated: Use `folder_ids` field instead. The ids of the sources
+   * used by the agent.
    */
   source_ids?: Array<string> | null;
 
@@ -1414,12 +1971,7 @@ export interface AgentUpdateParams {
   > | null;
 }
 
-export interface AgentListParams {
-  /**
-   * Cursor for pagination
-   */
-  after?: string | null;
-
+export interface AgentListParams extends ArrayPageParams {
   /**
    * @deprecated Whether to sort agents oldest to newest (True) or newest to oldest
    * (False, default)
@@ -1431,11 +1983,6 @@ export interface AgentListParams {
    */
   base_template_id?: string | null;
 
-  /**
-   * Cursor for pagination
-   */
-  before?: string | null;
-
   /**
    * Search agents by identifier keys
    */
@@ -1446,17 +1993,32 @@ export interface AgentListParams {
    */
   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 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;
 
   /**
-   * Limit for pagination
+   * Filter agents by their last stop reason.
    */
-  limit?: number | null;
+  last_stop_reason?: RunsAPI.StopReasonType | null;
 
   /**
    * If True, only returns agents that match ALL given tags. Otherwise, return agents
@@ -1469,17 +2031,6 @@ export interface AgentListParams {
    */
   name?: string | null;
 
-  /**
-   * Sort order for agents by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at' | 'last_run_completion';
-
   /**
    * Search agents by project ID - this will default to your default project on cloud
    */
@@ -1507,254 +2058,137 @@ export interface AgentListParams {
   template_id?: string | null;
 }
 
-export interface AgentExportParams {
+export interface AgentExportFileParams {
+  /**
+   * @deprecated
+   */
   max_steps?: number;
 
   /**
-   * If true, exports using the legacy single-agent format (v1). If false, exports
-   * using the new multi-entity format (v2).
+   * @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 AgentImportParams {
+export interface AgentImportFileParams {
   /**
    * Body param:
    */
   file: Uploadable;
 
   /**
-   * Body param: If set to True, appends "\_copy" to the end of the agent name.
+   * @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.
+   * Body param: Embedding handle to override with.
    */
-  env_vars_json?: string | null;
+  embedding?: string | null;
 
   /**
-   * Body param: Override import with specific embedding handle.
+   * @deprecated Body param: Environment variables as a JSON string to pass to the
+   * agent for tool execution. Use 'secrets' instead.
    */
-  override_embedding_handle?: string | null;
+  env_vars_json?: 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.
+   * Body param: If provided, overrides the agent name with this value.
    */
-  override_existing_tools?: boolean;
+  name?: string | null;
 
   /**
-   * Body param: The project ID to associate the uploaded agent with.
+   * @deprecated Body param: Override import with specific embedding handle. Use
+   * 'embedding' instead.
    */
-  project_id?: string | null;
+  override_embedding_handle?: string | null;
 
   /**
-   * Body param: If set to True, strips all messages from the agent before importing.
+   * 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.
    */
-  strip_messages?: boolean;
+  override_existing_tools?: boolean;
 
   /**
-   * Header param:
+   * @deprecated Body param: If provided, overrides the agent name with this value.
+   * Use 'name' instead.
    */
-  'x-override-embedding-model'?: string;
-}
+  override_name?: string | null;
 
-export interface AgentListGroupsParams {
   /**
-   * Manager type to filter groups by
+   * @deprecated Body param: The project ID to associate the uploaded agent with.
+   * This is now passed via headers.
    */
-  manager_type?: string | null;
-}
-
-export interface AgentMigrateParams {
-  preserve_core_memories: boolean;
-
-  to_template: string;
+  project_id?: string | null;
 
   /**
-   * If true, preserves the existing agent's tool environment variables instead of
-   * using the template's variables
+   * Body param: Secrets as a JSON string to pass to the agent for tool execution.
    */
-  preserve_tool_variables?: boolean;
-}
+  secrets?: string | null;
 
-export interface AgentResetMessagesParams {
   /**
-   * If true, adds the default initial messages after resetting.
+   * Body param: If set to True, strips all messages from the agent before importing.
    */
-  add_default_initial_messages?: boolean;
-}
-
-export interface AgentSearchParams {
-  after?: string | null;
-
-  ascending?: boolean;
-
-  combinator?: 'AND';
-
-  limit?: number;
-
-  project_id?: string;
-
-  search?: Array<
-    | AgentSearchParams.UnionMember0
-    | AgentSearchParams.UnionMember1
-    | AgentSearchParams.UnionMember2
-    | AgentSearchParams.UnionMember3
-    | AgentSearchParams.UnionMember4
-  >;
-
-  sortBy?: 'created_at' | 'last_run_completion';
-}
-
-export namespace AgentSearchParams {
-  export interface UnionMember0 {
-    field: 'version';
-
-    value: string;
-  }
-
-  export interface UnionMember1 {
-    field: 'name';
-
-    operator: 'eq' | 'contains';
-
-    value: string;
-  }
-
-  export interface UnionMember2 {
-    field: 'tags';
-
-    operator: 'contains';
-
-    value: Array<string>;
-  }
-
-  export interface UnionMember3 {
-    field: 'identity';
-
-    operator: 'eq';
-
-    value: string;
-  }
-
-  export interface UnionMember4 {
-    field: 'templateName';
-
-    operator: 'eq';
-
-    value: string;
-  }
-}
+  strip_messages?: boolean;
 
-export interface AgentSummarizeParams {
   /**
-   * Maximum number of messages to retain after summarization.
+   * Header param:
    */
-  max_message_length: number;
+  'x-override-embedding-model'?: string;
 }
 
+Agents.Messages = Messages;
+Agents.Blocks = Blocks;
 Agents.Tools = Tools;
-Agents.Sources = Sources;
 Agents.Folders = Folders;
 Agents.Files = Files;
-Agents.CoreMemory = CoreMemory;
-Agents.ArchivalMemory = ArchivalMemory;
-Agents.Messages = Messages;
+Agents.Groups = Groups;
+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 AgentListResponse as AgentListResponse,
+    type TogetherModelSettings as TogetherModelSettings,
+    type XaiModelSettings as XaiModelSettings,
     type AgentDeleteResponse as AgentDeleteResponse,
-    type AgentCountResponse as AgentCountResponse,
-    type AgentExportResponse as AgentExportResponse,
-    type AgentImportResponse as AgentImportResponse,
-    type AgentListGroupsResponse as AgentListGroupsResponse,
-    type AgentMigrateResponse as AgentMigrateResponse,
-    type AgentRetrieveContextResponse as AgentRetrieveContextResponse,
-    type AgentSearchResponse as AgentSearchResponse,
+    type AgentExportFileResponse as AgentExportFileResponse,
+    type AgentImportFileResponse as AgentImportFileResponse,
+    type AgentStatesArrayPage as AgentStatesArrayPage,
     type AgentCreateParams as AgentCreateParams,
     type AgentRetrieveParams as AgentRetrieveParams,
     type AgentUpdateParams as AgentUpdateParams,
     type AgentListParams as AgentListParams,
-    type AgentExportParams as AgentExportParams,
-    type AgentImportParams as AgentImportParams,
-    type AgentListGroupsParams as AgentListGroupsParams,
-    type AgentMigrateParams as AgentMigrateParams,
-    type AgentResetMessagesParams as AgentResetMessagesParams,
-    type AgentSearchParams as AgentSearchParams,
-    type AgentSummarizeParams as AgentSummarizeParams,
-  };
-
-  export {
-    Tools as Tools,
-    type ToolListResponse as ToolListResponse,
-    type ToolAttachParams as ToolAttachParams,
-    type ToolDetachParams as ToolDetachParams,
-    type ToolModifyApprovalParams as ToolModifyApprovalParams,
-  };
-
-  export {
-    Sources as Sources,
-    type SourceListResponse as SourceListResponse,
-    type SourceAttachParams as SourceAttachParams,
-    type SourceDetachParams as SourceDetachParams,
-  };
-
-  export {
-    Folders as Folders,
-    type FolderListResponse as FolderListResponse,
-    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 FileListParams as FileListParams,
-    type FileCloseParams as FileCloseParams,
-    type FileOpenParams as FileOpenParams,
-  };
-
-  export {
-    CoreMemory as CoreMemory,
-    type Memory as Memory,
-    type CoreMemoryRetrieveVariablesResponse as CoreMemoryRetrieveVariablesResponse,
-  };
-
-  export {
-    ArchivalMemory as ArchivalMemory,
-    type ArchivalMemoryCreateResponse as ArchivalMemoryCreateResponse,
-    type ArchivalMemoryListResponse as ArchivalMemoryListResponse,
-    type ArchivalMemoryDeleteResponse as ArchivalMemoryDeleteResponse,
-    type ArchivalMemorySearchResponse as ArchivalMemorySearchResponse,
-    type ArchivalMemoryCreateParams as ArchivalMemoryCreateParams,
-    type ArchivalMemoryListParams as ArchivalMemoryListParams,
-    type ArchivalMemoryDeleteParams as ArchivalMemoryDeleteParams,
-    type ArchivalMemorySearchParams as ArchivalMemorySearchParams,
+    type AgentExportFileParams as AgentExportFileParams,
+    type AgentImportFileParams as AgentImportFileParams,
   };
 
   export {
@@ -1762,16 +2196,19 @@ export declare namespace Agents {
     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,
+    type LettaStreamingResponse as LettaStreamingResponse,
     type LettaUserMessageContentUnion as LettaUserMessageContentUnion,
     type Message as Message,
     type MessageRole as MessageRole,
@@ -1781,6 +2218,7 @@ export declare namespace Agents {
     type ReasoningMessage as ReasoningMessage,
     type RedactedReasoningContent as RedactedReasoningContent,
     type Run as Run,
+    type SummaryMessage as SummaryMessage,
     type SystemMessage as SystemMessage,
     type TextContent as TextContent,
     type ToolCall as ToolCall,
@@ -1794,19 +2232,73 @@ export declare namespace Agents {
     type UpdateSystemMessage as UpdateSystemMessage,
     type UpdateUserMessage as UpdateUserMessage,
     type UserMessage as UserMessage,
-    type MessageUpdateResponse as MessageUpdateResponse,
-    type MessageListResponse as MessageListResponse,
     type MessageCancelResponse as MessageCancelResponse,
-    type MessagePreviewRawPayloadResponse as MessagePreviewRawPayloadResponse,
-    type MessageSearchResponse as MessageSearchResponse,
-    type MessageSendStreamResponse as MessageSendStreamResponse,
-    type MessageUpdateParams as MessageUpdateParams,
+    type MessagesArrayPage as MessagesArrayPage,
+    type MessageCreateParams as MessageCreateParams,
+    type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
+    type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
     type MessageListParams as MessageListParams,
     type MessageCancelParams as MessageCancelParams,
-    type MessagePreviewRawPayloadParams as MessagePreviewRawPayloadParams,
-    type MessageSearchParams as MessageSearchParams,
-    type MessageSendParams as MessageSendParams,
-    type MessageSendAsyncParams as MessageSendAsyncParams,
-    type MessageSendStreamParams as MessageSendStreamParams,
+    type MessageCreateAsyncParams as MessageCreateAsyncParams,
+    type MessageResetParams as MessageResetParams,
+    type MessageStreamParams as MessageStreamParams,
+  };
+
+  export {
+    Blocks as Blocks,
+    type Block as Block,
+    type BlockUpdate as BlockUpdate,
+    type BlockRetrieveParams as BlockRetrieveParams,
+    type BlockUpdateParams as BlockUpdateParams,
+    type BlockListParams as BlockListParams,
+    type BlockAttachParams as BlockAttachParams,
+    type BlockDetachParams as BlockDetachParams,
+  };
+
+  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,
   };
 }