@letta-ai/letta-client 1.0.0-alpha.7 → 1.1.0

package/src/resources/agents/agents.ts

@@ -2,15 +2,21 @@
 
 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,
   BlockAttachParams,
   BlockDetachParams,
   BlockListParams,
-  BlockListResponse,
   BlockRetrieveParams,
   BlockUpdate,
   BlockUpdateParams,
@@ -23,6 +29,7 @@ import {
   FileCloseResponse,
   FileListParams,
   FileListResponse,
+  FileListResponsesNextFilesPage,
   FileOpenParams,
   FileOpenResponse,
   Files,
@@ -33,46 +40,58 @@ import {
   FolderDetachParams,
   FolderListParams,
   FolderListResponse,
+  FolderListResponsesArrayPage,
   Folders,
 } from './folders';
 import * as GroupsAPI from './groups';
-import { GroupListParams, GroupListResponse, Groups } 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,
   MessageResetParams,
   MessageRole,
-  MessageSendAsyncParams,
-  MessageSendParams,
   MessageStreamParams,
-  MessageStreamResponse,
   MessageType,
-  MessageUpdateParams,
-  MessageUpdateResponse,
   Messages,
+  MessagesArrayPage,
   OmittedReasoningContent,
   ReasoningContent,
   ReasoningMessage,
   RedactedReasoningContent,
   Run,
+  SummaryMessage,
   SystemMessage,
   TextContent,
   ToolCall,
@@ -88,19 +107,15 @@ import {
   UserMessage,
 } from './messages';
 import * as AgentsToolsAPI from './tools';
-import {
-  ToolAttachParams,
-  ToolDetachParams,
-  ToolListParams,
-  ToolListResponse,
-  ToolUpdateApprovalParams,
-  Tools,
-} 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';
+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';
@@ -108,26 +123,20 @@ 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.
    */
-  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 });
   }
 
   /**
@@ -154,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 });
   }
 
   /**
@@ -165,13 +174,6 @@ 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.
@@ -211,6 +213,8 @@ export class Agents extends APIResource {
   }
 }
 
+export type AgentStatesArrayPage = ArrayPage<AgentState>;
+
 export interface AgentEnvironmentVariable {
   /**
    * The ID of the agent this environment variable belongs to.
@@ -267,16 +271,6 @@ export interface AgentEnvironmentVariable {
  * Representation of an agent's state. This is the state of the agent at a given
  * time, and is persisted in the DB backend. The state has all the information
  * needed to recreate a persisted agent.
- *
- * Parameters: id (str): The unique identifier of the agent. name (str): The name
- * of the agent (must be unique to the user). created_at (datetime): The datetime
- * the agent was created. message_ids (List[str]): The ids of the messages in the
- * agent's in-context memory. memory (Memory): The in-context memory of the agent.
- * tools (List[str]): The tools used by the agent. This includes any memory editing
- * functions specified in `memory`. system (str): The system prompt used by the
- * agent. llm_config (LLMConfig): The LLM configuration used by the agent.
- * embedding_config (EmbeddingConfig): The embedding configuration used by the
- * agent.
  */
 export interface AgentState {
   /**
@@ -295,17 +289,20 @@ export interface AgentState {
   blocks: Array<BlocksAPI.Block>;
 
   /**
-   * The embedding configuration used by the agent.
+   * @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;
 
   /**
-   * @deprecated The in-context memory of the agent.
+   * @deprecated Deprecated: Use `blocks` field instead. The in-context memory of the
+   * agent.
    */
   memory: AgentState.Memory;
 
@@ -315,7 +312,8 @@ 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<AgentState.Source>;
 
@@ -359,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.
    */
@@ -377,10 +380,11 @@ export interface AgentState {
   /**
    * The identities associated with this agent.
    */
-  identities?: Array<IdentitiesAPI.Identity>;
+  identities?: Array<IdentitiesIdentitiesAPI.Identity>;
 
   /**
-   * @deprecated The ids of the identities associated with this agent.
+   * @deprecated Deprecated: Use `identities` field instead. The ids of the
+   * identities associated with this agent.
    */
   identity_ids?: Array<string>;
 
@@ -394,6 +398,11 @@ 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.
    */
@@ -428,7 +437,29 @@ export interface AgentState {
   metadata?: { [key: string]: unknown } | null;
 
   /**
-   * @deprecated The multi-agent group that this agent manages
+   * The model handle used by the agent (format: provider/model-name).
+   */
+  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;
 
@@ -444,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;
 
@@ -491,7 +522,8 @@ export interface AgentState {
 
 export namespace AgentState {
   /**
-   * @deprecated The in-context memory of the agent.
+   * @deprecated Deprecated: Use `blocks` field instead. The in-context memory of the
+   * agent.
    */
   export interface Memory {
     /**
@@ -528,7 +560,8 @@ export namespace AgentState {
       is_open: boolean;
 
       /**
-       * Unique identifier of the source.
+       * @deprecated Deprecated: Use `folder_id` field instead. Unique identifier of the
+       * source.
        */
       source_id: string;
 
@@ -603,11 +636,6 @@ export namespace AgentState {
        */
       metadata?: { [key: string]: unknown } | null;
 
-      /**
-       * The id of the template.
-       */
-      name?: string | null;
-
       /**
        * Preserve the block on template migration.
        */
@@ -622,19 +650,29 @@ export namespace AgentState {
        * 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;
     }
   }
 
   /**
-   * Representation of a source, which is a collection of files and passages.
-   *
-   * Parameters: id (str): The ID of the source name (str): The name of the source.
-   * embedding_config (EmbeddingConfig): The embedding configuration used by the
-   * source. user_id (str): The ID of the user that created the source. metadata
-   * (dict): Metadata associated with the source. description (str): The description
-   * of the source.
+   * (Deprecated: Use Folder) Representation of a source, which is a collection of
+   * files and passages.
    */
   export interface Source {
+    /**
+     * The human-friendly ID of the Source
+     */
+    id: string;
+
     /**
      * The embedding configuration used by the source.
      */
@@ -645,11 +683,6 @@ export namespace AgentState {
      */
     name: string;
 
-    /**
-     * The human-friendly ID of the Source
-     */
-    id?: string;
-
     /**
      * The timestamp when the source was created.
      */
@@ -688,7 +721,7 @@ export namespace AgentState {
     /**
      * The vector database provider used for this source's passages
      */
-    vector_db_provider?: ArchivesAPI.VectorDBProvider;
+    vector_db_provider?: ArchivesArchivesAPI.VectorDBProvider;
   }
 }
 
@@ -706,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.
  */
@@ -806,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.
  */
@@ -939,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.
@@ -1027,11 +1371,67 @@ export interface TextResponseFormat {
   type?: 'text';
 }
 
-export type AgentListResponse = Array<AgentState>;
+/**
+ * Together AI model configuration (OpenAI-compatible).
+ */
+export interface TogetherModelSettings {
+  /**
+   * The maximum number of tokens the model can generate.
+   */
+  max_output_tokens?: number;
 
-export type AgentDeleteResponse = unknown;
+  /**
+   * Whether to enable parallel tool calling.
+   */
+  parallel_tool_calls?: boolean;
 
-export type AgentCountResponse = number;
+  /**
+   * 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;
 
@@ -1047,241 +1447,270 @@ export interface AgentImportFileResponse {
 
 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: Deprecated: please use the 'create agents from a template' endpoint
+   * 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<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: If set to True, enables parallel tool calling. Defaults to False.
+   * @deprecated Deprecated: Use `model` field to configure parallel tool calls
+   * instead. If set to True, enables parallel tool calling.
    */
   parallel_tool_calls?: boolean | null;
 
   /**
-   * 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.
+   * 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: Deprecated: No longer used
+   * @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
@@ -1296,14 +1725,9 @@ 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 {
@@ -1352,8 +1776,7 @@ export interface AgentUpdateParams {
   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;
 
@@ -1367,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.
    */
@@ -1387,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;
 
@@ -1399,8 +1837,8 @@ export interface AgentUpdateParams {
   max_files_open?: number | null;
 
   /**
-   * 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;
 
@@ -1422,18 +1860,34 @@ 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;
 
   /**
-   * If set to True, enables parallel tool calling. Defaults to False.
+   * @deprecated Deprecated: Use `model` field to configure parallel tool calls
+   * instead. If set to True, enables parallel tool calling.
    */
   parallel_tool_calls?: boolean | null;
 
@@ -1449,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;
@@ -1464,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;
 
@@ -1514,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)
@@ -1531,11 +1983,6 @@ export interface AgentListParams {
    */
   base_template_id?: string | null;
 
-  /**
-   * Cursor for pagination
-   */
-  before?: string | null;
-
   /**
    * Search agents by identifier keys
    */
@@ -1569,9 +2016,9 @@ export interface AgentListParams {
   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
@@ -1584,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
    */
@@ -1649,13 +2085,24 @@ export interface AgentImportFileParams {
   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.
+   */
+  embedding?: string | null;
+
+  /**
+   * @deprecated Body param: Environment variables as a JSON string to pass to the
+   * agent for tool execution. Use 'secrets' instead.
    */
   env_vars_json?: string | null;
 
   /**
-   * Body param: Override import with specific embedding handle.
+   * Body param: If provided, overrides the agent name with this value.
+   */
+  name?: string | null;
+
+  /**
+   * @deprecated Body param: Override import with specific embedding handle. Use
+   * 'embedding' instead.
    */
   override_embedding_handle?: string | null;
 
@@ -1667,15 +2114,22 @@ export interface AgentImportFileParams {
   override_existing_tools?: boolean;
 
   /**
-   * Body param: If provided, overrides the agent name with this value.
+   * @deprecated Body param: If provided, overrides the agent name with this value.
+   * Use 'name' instead.
    */
   override_name?: string | null;
 
   /**
-   * Body param: The project ID to associate the uploaded agent with.
+   * @deprecated Body param: The project ID to associate the uploaded agent with.
+   * This is now passed via headers.
    */
   project_id?: string | null;
 
+  /**
+   * Body param: Secrets as a JSON string to pass to the agent for tool execution.
+   */
+  secrets?: string | null;
+
   /**
    * Body param: If set to True, strips all messages from the agent before importing.
    */
@@ -1687,37 +2141,48 @@ export interface AgentImportFileParams {
   'x-override-embedding-model'?: string;
 }
 
+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 AgentListResponse as AgentListResponse,
+    type TogetherModelSettings as TogetherModelSettings,
+    type XaiModelSettings as XaiModelSettings,
     type AgentDeleteResponse as AgentDeleteResponse,
-    type AgentCountResponse as AgentCountResponse,
     type AgentExportFileResponse as AgentExportFileResponse,
     type AgentImportFileResponse as AgentImportFileResponse,
+    type AgentStatesArrayPage as AgentStatesArrayPage,
     type AgentCreateParams as AgentCreateParams,
     type AgentRetrieveParams as AgentRetrieveParams,
     type AgentUpdateParams as AgentUpdateParams,
@@ -1726,67 +2191,24 @@ export declare namespace Agents {
     type AgentImportFileParams as AgentImportFileParams,
   };
 
-  export {
-    Tools as Tools,
-    type ToolListResponse as ToolListResponse,
-    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 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 FileListParams as FileListParams,
-    type FileCloseParams as FileCloseParams,
-    type FileOpenParams as FileOpenParams,
-  };
-
-  export {
-    Blocks as Blocks,
-    type Block as Block,
-    type BlockUpdate as BlockUpdate,
-    type BlockListResponse as BlockListResponse,
-    type BlockRetrieveParams as BlockRetrieveParams,
-    type BlockUpdateParams as BlockUpdateParams,
-    type BlockListParams as BlockListParams,
-    type BlockAttachParams as BlockAttachParams,
-    type BlockDetachParams as BlockDetachParams,
-  };
-
-  export {
-    Groups as Groups,
-    type GroupListResponse as GroupListResponse,
-    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,
+    type LettaStreamingResponse as LettaStreamingResponse,
     type LettaUserMessageContentUnion as LettaUserMessageContentUnion,
     type Message as Message,
     type MessageRole as MessageRole,
@@ -1796,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,
@@ -1809,16 +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 MessageStreamResponse as MessageStreamResponse,
-    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 MessageCreateAsyncParams as MessageCreateAsyncParams,
     type MessageResetParams as MessageResetParams,
-    type MessageSendParams as MessageSendParams,
-    type MessageSendAsyncParams as MessageSendAsyncParams,
     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,
+  };
 }