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

package/resources/agents/agents.d.ts

@@ -1,38 +1,45 @@
 import { APIResource } from "../../core/resource.js";
-import * as BlocksAPI from "../blocks.js";
-import * as ModelsAPI from "../models.js";
-import * as ArchivalMemoryAPI from "./archival-memory.js";
-import { ArchivalMemory, ArchivalMemoryCreateParams, ArchivalMemoryCreateResponse, ArchivalMemoryDeleteParams, ArchivalMemoryDeleteResponse, ArchivalMemoryListParams, ArchivalMemoryListResponse, ArchivalMemorySearchParams, ArchivalMemorySearchResponse } from "./archival-memory.js";
+import * as AgentsAPI from "./agents.js";
+import * as ToolsAPI from "../tools.js";
+import * as ArchivesAPI from "./archives.js";
+import { ArchiveAttachParams, ArchiveAttachResponse, ArchiveDetachParams, ArchiveDetachResponse, Archives } from "./archives.js";
+import * as BlocksAPI from "./blocks.js";
+import { Block, BlockAttachParams, BlockDetachParams, BlockListParams, BlockRetrieveParams, BlockUpdate, BlockUpdateParams, Blocks } from "./blocks.js";
 import * as FilesAPI from "./files.js";
-import { FileCloseAllResponse, FileCloseParams, FileCloseResponse, FileListParams, FileListResponse, FileOpenParams, FileOpenResponse, Files } from "./files.js";
+import { FileCloseAllResponse, FileCloseParams, FileCloseResponse, FileListParams, FileListResponse, FileListResponsesNextFilesPage, FileOpenParams, FileOpenResponse, Files } from "./files.js";
 import * as FoldersAPI from "./folders.js";
-import { FolderAttachParams, FolderDetachParams, FolderListResponse, Folders } from "./folders.js";
+import { FolderAttachParams, FolderDetachParams, FolderListParams, FolderListResponse, FolderListResponsesArrayPage, Folders } from "./folders.js";
+import * as GroupsAPI from "./groups.js";
+import { GroupListParams, Groups } from "./groups.js";
+import * as IdentitiesAPI from "./identities.js";
+import { Identities, IdentityAttachParams, IdentityAttachResponse, IdentityDetachParams, IdentityDetachResponse } from "./identities.js";
 import * as MessagesAPI from "./messages.js";
-import { ApprovalCreate, ApprovalRequestMessage, ApprovalResponseMessage, AssistantMessage, HiddenReasoningMessage, ImageContent, JobStatus, JobType, LettaAssistantMessageContentUnion, LettaMessageUnion, LettaRequest, LettaResponse, LettaStreamingRequest, LettaUserMessageContentUnion, Message, MessageCancelParams, MessageCancelResponse, MessageListParams, MessageListResponse, MessagePreviewRawPayloadParams, MessagePreviewRawPayloadResponse, MessageRole, MessageSearchParams, MessageSearchResponse, MessageSendAsyncParams, MessageSendParams, MessageSendStreamParams, MessageSendStreamResponse, MessageType, MessageUpdateParams, MessageUpdateResponse, Messages, OmittedReasoningContent, ReasoningContent, ReasoningMessage, RedactedReasoningContent, Run, SystemMessage, TextContent, ToolCall, ToolCallContent, ToolCallDelta, ToolCallMessage, ToolReturn, ToolReturnContent, UpdateAssistantMessage, UpdateReasoningMessage, UpdateSystemMessage, UpdateUserMessage, UserMessage } from "./messages.js";
-import * as SourcesAPI from "./sources.js";
-import { SourceAttachParams, SourceDetachParams, SourceListResponse, Sources } from "./sources.js";
-import * as ToolsAPI from "./tools.js";
-import { ToolAttachParams, ToolDetachParams, ToolListResponse, ToolModifyApprovalParams, Tools } from "./tools.js";
-import * as GroupsAPI from "../groups/groups.js";
-import * as SourcesSourcesAPI from "../sources/sources.js";
-import * as ToolsToolsAPI from "../tools/tools.js";
-import * as CoreMemoryAPI from "./core-memory/core-memory.js";
-import { CoreMemory, CoreMemoryRetrieveVariablesResponse, Memory } from "./core-memory/core-memory.js";
+import { ApprovalCreate, ApprovalRequestMessage, ApprovalResponseMessage, ApprovalReturn, AssistantMessage, EventMessage, HiddenReasoningMessage, ImageContent, InternalMessage, JobStatus, JobType, LettaAssistantMessageContentUnion, LettaRequest, LettaResponse, LettaStreamingRequest, LettaStreamingResponse, LettaUserMessageContentUnion, Message, MessageCancelParams, MessageCancelResponse, MessageCreateAsyncParams, MessageCreateParams, MessageCreateParamsNonStreaming, MessageCreateParamsStreaming, MessageListParams, MessageResetParams, MessageRole, MessageStreamParams, MessageType, Messages, MessagesArrayPage, OmittedReasoningContent, ReasoningContent, ReasoningMessage, RedactedReasoningContent, Run, SummaryMessage, SystemMessage, TextContent, ToolCall, ToolCallContent, ToolCallDelta, ToolCallMessage, ToolReturn, ToolReturnContent, UpdateAssistantMessage, UpdateReasoningMessage, UpdateSystemMessage, UpdateUserMessage, UserMessage } from "./messages.js";
+import * as AgentsToolsAPI from "./tools.js";
+import { ToolAttachParams, ToolDetachParams, ToolListParams, ToolUpdateApprovalParams, Tools } from "./tools.js";
+import * as ArchivesArchivesAPI from "../archives/archives.js";
+import * as BlocksBlocksAPI from "../blocks/blocks.js";
+import * as GroupsGroupsAPI from "../groups/groups.js";
+import * as IdentitiesIdentitiesAPI from "../identities/identities.js";
+import * as ModelsAPI from "../models/models.js";
+import * as RunsAPI from "../runs/runs.js";
 import { APIPromise } from "../../core/api-promise.js";
+import { ArrayPage, type ArrayPageParams, PagePromise } from "../../core/pagination.js";
 import { type Uploadable } from "../../core/uploads.js";
 import { RequestOptions } from "../../internal/request-options.js";
 export declare class Agents extends APIResource {
-    tools: ToolsAPI.Tools;
-    sources: SourcesAPI.Sources;
+    messages: MessagesAPI.Messages;
+    blocks: BlocksAPI.Blocks;
+    tools: AgentsToolsAPI.Tools;
     folders: FoldersAPI.Folders;
     files: FilesAPI.Files;
-    coreMemory: CoreMemoryAPI.CoreMemory;
-    archivalMemory: ArchivalMemoryAPI.ArchivalMemory;
-    messages: MessagesAPI.Messages;
+    groups: GroupsAPI.Groups;
+    archives: ArchivesAPI.Archives;
+    identities: IdentitiesAPI.Identities;
     /**
      * Create an agent.
      */
-    create(params: AgentCreateParams, options?: RequestOptions): APIPromise<AgentState>;
+    create(body: AgentCreateParams, options?: RequestOptions): APIPromise<AgentState>;
     /**
      * Get the state of the agent.
      */
@@ -44,60 +51,23 @@ export declare class Agents extends APIResource {
     /**
      * Get a list of all agents.
      */
-    list(query?: AgentListParams | null | undefined, options?: RequestOptions): APIPromise<AgentListResponse>;
+    list(query?: AgentListParams | null | undefined, options?: RequestOptions): PagePromise<AgentStatesArrayPage, AgentState>;
     /**
      * Delete an agent.
      */
     delete(agentID: string, options?: RequestOptions): APIPromise<unknown>;
-    /**
-     * Get the total number of agents.
-     */
-    count(options?: RequestOptions): APIPromise<AgentCountResponse>;
     /**
      * 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(agentID: string, query?: AgentExportParams | null | undefined, options?: RequestOptions): APIPromise<string>;
+    exportFile(agentID: string, query?: AgentExportFileParams | null | undefined, options?: RequestOptions): APIPromise<string>;
     /**
      * 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>;
-    /**
-     * Lists the groups for an agent
-     */
-    listGroups(agentID: string, query?: AgentListGroupsParams | null | undefined, options?: RequestOptions): APIPromise<AgentListGroupsResponse>;
-    /**
-     * 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>;
-    /**
-     * Resets the messages for an agent
-     */
-    resetMessages(agentID: string, params?: AgentResetMessagesParams | null | undefined, options?: RequestOptions): APIPromise<AgentState>;
-    /**
-     * Retrieve the context window of a specific agent.
-     */
-    retrieveContext(agentID: string, options?: RequestOptions): APIPromise<AgentRetrieveContextResponse>;
-    /**
-     * Search deployed agents
-     */
-    search(body?: AgentSearchParams | null | undefined, options?: RequestOptions): APIPromise<AgentSearchResponse>;
-    /**
-     * 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>;
+    importFile(params: AgentImportFileParams, options?: RequestOptions): APIPromise<AgentImportFileResponse>;
 }
+export type AgentStatesArrayPage = ArrayPage<AgentState>;
 export interface AgentEnvironmentVariable {
     /**
      * The ID of the agent this environment variable belongs to.
@@ -135,21 +105,15 @@ 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 {
     /**
@@ -161,25 +125,33 @@ 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.
      */
     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.
      */
@@ -191,7 +163,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.
      */
@@ -212,6 +184,10 @@ export interface AgentState {
      * The description of the agent.
      */
     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.
      */
@@ -225,7 +201,12 @@ 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>;
     /**
@@ -236,10 +217,18 @@ export interface AgentState {
      * The duration in milliseconds of the agent's last run.
      */
     last_run_duration_ms?: number | null;
+    /**
+     * The stop reason from the agent's last run.
+     */
+    last_stop_reason?: RunsAPI.StopReasonType | null;
     /**
      * 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.
@@ -262,9 +251,18 @@ export interface AgentState {
         [key: string]: unknown;
     } | null;
     /**
-     * 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?: GroupsAPI.Group | null;
+    multi_agent_group?: GroupsGroupsAPI.Group | 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.
@@ -275,7 +273,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;
     /**
@@ -303,10 +301,273 @@ export interface AgentState {
      */
     updated_at?: string | null;
 }
+export declare namespace AgentState {
+    /**
+     * @deprecated Deprecated: Use `blocks` field instead. The in-context memory of the
+     * agent.
+     */
+    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;
+    }
+    namespace Memory {
+        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.
+     */
+    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' | 'react_agent' | 'workflow_agent' | 'split_thread_agent' | 'sleeptime_agent' | 'voice_convo_agent' | 'voice_sleeptime_agent';
+export type AgentType = 'memgpt_agent' | 'memgpt_v2_agent' | 'letta_v1_agent' | 'react_agent' | 'workflow_agent' | 'split_thread_agent' | 'sleeptime_agent' | 'voice_convo_agent' | 'voice_sleeptime_agent';
+export interface AnthropicModelSettings {
+    /**
+     * 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 declare namespace AnthropicModelSettings {
+    /**
+     * The thinking configuration for the model.
+     */
+    interface Thinking {
+        /**
+         * The maximum number of tokens the model can use for extended thinking.
+         */
+        budget_tokens?: number;
+        /**
+         * The type of thinking to use.
+         */
+        type?: 'enabled' | 'disabled';
+    }
+}
+/**
+ * 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.
  */
@@ -319,12 +580,39 @@ export interface ChildToolRule {
      * The name of the tool. Must exist in the database for the user's organization.
      */
     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).
      */
     prompt_template?: string | null;
     type?: 'constrain_child_tools';
 }
+export declare 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).
+     */
+    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.
  */
@@ -368,6 +656,138 @@ export interface ContinueToolRule {
     prompt_template?: string | null;
     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 declare namespace GoogleAIModelSettings {
+    /**
+     * The thinking configuration for the model.
+     */
+    interface ThinkingConfig {
+        /**
+         * Whether to include thoughts in the model's response.
+         */
+        include_thoughts?: boolean;
+        /**
+         * The thinking budget for the model.
+         */
+        thinking_budget?: number;
+    }
+}
+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 declare namespace GoogleVertexModelSettings {
+    /**
+     * The thinking configuration for the model.
+     */
+    interface ThinkingConfig {
+        /**
+         * Whether to include thoughts in the model's response.
+         */
+        include_thoughts?: boolean;
+        /**
+         * The thinking budget for the model.
+         */
+        thinking_budget?: number;
+    }
+}
+/**
+ * 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.
  */
@@ -376,6 +796,16 @@ export interface InitToolRule {
      * The name of the tool. Must exist in the database for the user's organization.
      */
     tool_name: string;
+    /**
+     * Optional prefilled arguments for this tool. When present, these values will
+     * override any LLM-provided arguments with the same keys during invocation. Keys
+     * must match the tool's parameter names and values must satisfy the tool's JSON
+     * schema. Supports partial prefill; non-overlapping parameters are left to the
+     * model.
+     */
+    args?: {
+        [key: string]: unknown;
+    } | null;
     /**
      * Optional template string (ignored). Rendering uses fast built-in formatting for
      * performance.
@@ -407,6 +837,9 @@ export interface JsonSchemaResponseFormat {
      */
     type?: 'json_schema';
 }
+/**
+ * Sent via the Anthropic Messages API
+ */
 export type LettaMessageContentUnion = MessagesAPI.TextContent | MessagesAPI.ImageContent | MessagesAPI.ToolCallContent | MessagesAPI.ToolReturnContent | MessagesAPI.ReasoningContent | MessagesAPI.RedactedReasoningContent | MessagesAPI.OmittedReasoningContent;
 /**
  * Represents a tool rule configuration which constrains the total number of times
@@ -465,6 +898,43 @@ 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 declare namespace OpenAIModelSettings {
+    /**
+     * The reasoning configuration for the model.
+     */
+    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.
@@ -539,333 +1009,303 @@ export interface TextResponseFormat {
      */
     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.
+ * Together AI model configuration (OpenAI-compatible).
  */
-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;
+export interface TogetherModelSettings {
     /**
-     * The content of the functions definitions.
+     * The maximum number of tokens the model can generate.
      */
-    functions_definitions: Array<AgentRetrieveContextResponse.FunctionsDefinition> | null;
+    max_output_tokens?: number;
     /**
-     * The messages in the context window.
+     * Whether to enable parallel tool calling.
      */
-    messages: Array<MessagesAPI.Message>;
+    parallel_tool_calls?: boolean;
     /**
-     * The number of messages in the archival memory.
+     * The type of the provider.
      */
-    num_archival_memory: number;
+    provider_type?: 'together';
     /**
-     * The number of messages in the context window.
+     * The response format for the model.
      */
-    num_messages: number;
-    /**
-     * The number of messages in the recall memory.
-     */
-    num_recall_memory: number;
-    /**
-     * The number of tokens in the core memory.
-     */
-    num_tokens_core_memory: number;
+    response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
     /**
-     * The number of tokens in the external memory summary (archival + recall
-     * metadata).
+     * The temperature of the model.
      */
-    num_tokens_external_memory_summary: number;
+    temperature?: number;
+}
+/**
+ * xAI model configuration (OpenAI-compatible).
+ */
+export interface XaiModelSettings {
     /**
-     * The number of tokens in the functions definitions.
+     * The maximum number of tokens the model can generate.
      */
-    num_tokens_functions_definitions: number;
+    max_output_tokens?: number;
     /**
-     * The number of tokens in the messages list.
+     * Whether to enable parallel tool calling.
      */
-    num_tokens_messages: number;
+    parallel_tool_calls?: boolean;
     /**
-     * The number of tokens in the summary memory.
+     * The type of the provider.
      */
-    num_tokens_summary_memory: number;
+    provider_type?: 'xai';
     /**
-     * The number of tokens in the system prompt.
+     * The response format for the model.
      */
-    num_tokens_system: number;
+    response_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
     /**
-     * The content of the system prompt.
+     * The temperature of the model.
      */
-    system_prompt: string;
+    temperature?: number;
+}
+export type AgentDeleteResponse = unknown;
+export type AgentExportFileResponse = string;
+/**
+ * Response model for imported agents
+ */
+export interface AgentImportFileResponse {
     /**
-     * The content of the summary memory.
+     * List of IDs of the imported agents
      */
-    summary_memory?: string | null;
-}
-export declare namespace AgentRetrieveContextResponse {
-    interface FunctionsDefinition {
-        function: FunctionsDefinition.Function;
-        type: 'function';
-        [k: string]: unknown;
-    }
-    namespace FunctionsDefinition {
-        interface Function {
-            name: string;
-            description?: string | null;
-            parameters?: {
-                [key: string]: unknown;
-            } | null;
-            strict?: boolean | null;
-            [k: string]: unknown;
-        }
-    }
-}
-export interface AgentSearchResponse {
-    agents: Array<AgentState>;
-    nextCursor?: string | null;
+    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 | InitToolRule | TerminalToolRule | ConditionalToolRule | ContinueToolRule | RequiredBeforeExitToolRule | MaxCountPerStepToolRule | ParentToolRule | RequiresApprovalToolRule> | 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;
 }
@@ -878,13 +1318,16 @@ export interface AgentUpdateParams {
      * The ids of the blocks used by the agent.
      */
     block_ids?: Array<string> | null;
+    /**
+     * The context window limit used by the agent.
+     */
+    context_window_limit?: number | null;
     /**
      * The description of the agent.
      */
     description?: string | null;
     /**
-     * The embedding 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;
     /**
@@ -895,6 +1338,10 @@ export interface AgentUpdateParams {
      * If set to True, memory management will move to a background agent thread.
      */
     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.
      */
@@ -911,8 +1358,17 @@ export interface AgentUpdateParams {
      * The duration in milliseconds of the agent's last run.
      */
     last_run_duration_ms?: number | null;
+    /**
+     * The stop reason from the agent's last run.
+     */
+    last_stop_reason?: RunsAPI.StopReasonType | null;
     /**
      * 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;
     /**
@@ -920,6 +1376,11 @@ export interface AgentUpdateParams {
      * too high may exceed the context window, which will break the agent.
      */
     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
@@ -937,14 +1398,22 @@ export interface AgentUpdateParams {
         [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.
@@ -955,10 +1424,12 @@ 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;
@@ -969,7 +1440,8 @@ export interface AgentUpdateParams {
         [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;
     /**
@@ -1003,11 +1475,7 @@ export interface AgentUpdateParams {
      */
     tool_rules?: Array<ChildToolRule | InitToolRule | TerminalToolRule | ConditionalToolRule | ContinueToolRule | RequiredBeforeExitToolRule | MaxCountPerStepToolRule | ParentToolRule | RequiresApprovalToolRule> | 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)
@@ -1017,10 +1485,6 @@ export interface AgentListParams {
      * Search agents by base template ID
      */
     base_template_id?: string | null;
-    /**
-     * Cursor for pagination
-     */
-    before?: string | null;
     /**
      * Search agents by identifier keys
      */
@@ -1029,16 +1493,22 @@ export interface AgentListParams {
      * Search agents by identity ID
      */
     identity_id?: string | null;
+    /**
+     * Specify which relational fields to include in the response. No relationships are
+     * included by default.
+     */
+    include?: Array<'agent.blocks' | 'agent.identities' | 'agent.managed_group' | 'agent.secrets' | 'agent.sources' | 'agent.tags' | 'agent.tools'>;
     /**
      * Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
      * in the response. If not provided, all relationships are loaded by default. Using
-     * this can optimize performance by reducing unnecessary joins.
+     * this 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
      * that have ANY of the passed-in tags.
@@ -1048,15 +1518,6 @@ export interface AgentListParams {
      * Name of the agent
      */
     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
      */
@@ -1079,30 +1540,44 @@ 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.
+     */
+    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;
     /**
@@ -1112,9 +1587,19 @@ export interface AgentImportParams {
      */
     override_existing_tools?: boolean;
     /**
-     * Body param: The project ID to associate the uploaded agent with.
+     * @deprecated Body param: If provided, overrides the agent name with this value.
+     * Use 'name' instead.
+     */
+    override_name?: string | null;
+    /**
+     * @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.
      */
@@ -1124,76 +1609,15 @@ export interface AgentImportParams {
      */
     'x-override-embedding-model'?: string;
 }
-export interface AgentListGroupsParams {
-    /**
-     * Manager type to filter groups by
-     */
-    manager_type?: string | null;
-}
-export interface AgentMigrateParams {
-    preserve_core_memories: boolean;
-    to_template: string;
-    /**
-     * If true, preserves the existing agent's tool environment variables instead of
-     * using the template's variables
-     */
-    preserve_tool_variables?: boolean;
-}
-export interface AgentResetMessagesParams {
-    /**
-     * If true, adds the default initial messages after resetting.
-     */
-    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 declare namespace AgentSearchParams {
-    interface UnionMember0 {
-        field: 'version';
-        value: string;
-    }
-    interface UnionMember1 {
-        field: 'name';
-        operator: 'eq' | 'contains';
-        value: string;
-    }
-    interface UnionMember2 {
-        field: 'tags';
-        operator: 'contains';
-        value: Array<string>;
-    }
-    interface UnionMember3 {
-        field: 'identity';
-        operator: 'eq';
-        value: string;
-    }
-    interface UnionMember4 {
-        field: 'templateName';
-        operator: 'eq';
-        value: string;
-    }
-}
-export interface AgentSummarizeParams {
-    /**
-     * Maximum number of messages to retain after summarization.
-     */
-    max_message_length: number;
-}
 export declare namespace Agents {
-    export { type AgentEnvironmentVariable as AgentEnvironmentVariable, type AgentState as AgentState, type AgentType as AgentType, type ChildToolRule as ChildToolRule, type ConditionalToolRule as ConditionalToolRule, type ContinueToolRule as ContinueToolRule, 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 ParentToolRule as ParentToolRule, type RequiredBeforeExitToolRule as RequiredBeforeExitToolRule, type RequiresApprovalToolRule as RequiresApprovalToolRule, type TerminalToolRule as TerminalToolRule, type TextResponseFormat as TextResponseFormat, type AgentListResponse as AgentListResponse, 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 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, };
-    export { Messages as Messages, type ApprovalCreate as ApprovalCreate, type ApprovalRequestMessage as ApprovalRequestMessage, type ApprovalResponseMessage as ApprovalResponseMessage, type AssistantMessage as AssistantMessage, type HiddenReasoningMessage as HiddenReasoningMessage, type ImageContent as ImageContent, 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 LettaUserMessageContentUnion as LettaUserMessageContentUnion, type Message as Message, type MessageRole as MessageRole, type MessageType as MessageType, type OmittedReasoningContent as OmittedReasoningContent, type ReasoningContent as ReasoningContent, type ReasoningMessage as ReasoningMessage, type RedactedReasoningContent as RedactedReasoningContent, type Run as Run, type SystemMessage as SystemMessage, type TextContent as TextContent, type ToolCall as ToolCall, type ToolCallContent as ToolCallContent, type ToolCallDelta as ToolCallDelta, type ToolCallMessage as ToolCallMessage, type ToolReturn as ToolReturn, type ToolReturnContent as ToolReturnContent, type UpdateAssistantMessage as UpdateAssistantMessage, type UpdateReasoningMessage as UpdateReasoningMessage, 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 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, };
+    export { type AgentEnvironmentVariable as AgentEnvironmentVariable, type AgentState as AgentState, type AgentType as AgentType, type AnthropicModelSettings as AnthropicModelSettings, type AzureModelSettings as AzureModelSettings, type BedrockModelSettings as BedrockModelSettings, type ChildToolRule as ChildToolRule, type ConditionalToolRule as ConditionalToolRule, type ContinueToolRule as ContinueToolRule, type DeepseekModelSettings as DeepseekModelSettings, type GoogleAIModelSettings as GoogleAIModelSettings, type GoogleVertexModelSettings as GoogleVertexModelSettings, type GroqModelSettings as GroqModelSettings, type InitToolRule as InitToolRule, type JsonObjectResponseFormat as JsonObjectResponseFormat, type JsonSchemaResponseFormat as JsonSchemaResponseFormat, type LettaMessageContentUnion as LettaMessageContentUnion, type MaxCountPerStepToolRule as MaxCountPerStepToolRule, type MessageCreate as MessageCreate, type OpenAIModelSettings as OpenAIModelSettings, type ParentToolRule as ParentToolRule, type RequiredBeforeExitToolRule as RequiredBeforeExitToolRule, type RequiresApprovalToolRule as RequiresApprovalToolRule, type TerminalToolRule as TerminalToolRule, type TextResponseFormat as TextResponseFormat, type TogetherModelSettings as TogetherModelSettings, type XaiModelSettings as XaiModelSettings, type AgentDeleteResponse as AgentDeleteResponse, type AgentExportFileResponse as AgentExportFileResponse, type AgentImportFileResponse as AgentImportFileResponse, type AgentStatesArrayPage as AgentStatesArrayPage, type AgentCreateParams as AgentCreateParams, type AgentRetrieveParams as AgentRetrieveParams, type AgentUpdateParams as AgentUpdateParams, type AgentListParams as AgentListParams, type AgentExportFileParams as AgentExportFileParams, type AgentImportFileParams as AgentImportFileParams, };
+    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 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, type MessageType as MessageType, type OmittedReasoningContent as OmittedReasoningContent, type ReasoningContent as ReasoningContent, 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, type ToolCallContent as ToolCallContent, type ToolCallDelta as ToolCallDelta, type ToolCallMessage as ToolCallMessage, type ToolReturn as ToolReturn, type ToolReturnContent as ToolReturnContent, type UpdateAssistantMessage as UpdateAssistantMessage, type UpdateReasoningMessage as UpdateReasoningMessage, type UpdateSystemMessage as UpdateSystemMessage, type UpdateUserMessage as UpdateUserMessage, type UserMessage as UserMessage, type MessageCancelResponse as MessageCancelResponse, 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 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, };
 }
 //# sourceMappingURL=agents.d.ts.map