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

package/resources/agents/agents.d.ts

@@ -1,33 +1,32 @@
 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 ArchivesAPI from "../archives.js";
+import * as ToolsAPI from "../tools.js";
+import * as BlocksAPI from "./blocks.js";
+import { Block, BlockAttachParams, BlockDetachParams, BlockListParams, BlockListResponse, 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 * as FoldersAPI from "./folders.js";
-import { FolderAttachParams, FolderDetachParams, FolderListResponse, Folders } from "./folders.js";
+import { FolderAttachParams, FolderDetachParams, FolderListParams, FolderListResponse, Folders } from "./folders.js";
+import * as GroupsAPI from "./groups.js";
+import { GroupListParams, GroupListResponse, Groups } from "./groups.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, AssistantMessage, HiddenReasoningMessage, ImageContent, JobStatus, JobType, LettaAssistantMessageContentUnion, LettaMessageUnion, LettaRequest, LettaResponse, LettaStreamingRequest, LettaUserMessageContentUnion, Message, MessageCancelParams, MessageCancelResponse, MessageListParams, MessageListResponse, MessageResetParams, MessageRole, MessageSendAsyncParams, MessageSendParams, MessageStreamParams, MessageStreamResponse, 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 AgentsToolsAPI from "./tools.js";
+import { ToolAttachParams, ToolDetachParams, ToolListParams, ToolListResponse, ToolUpdateApprovalParams, Tools } from "./tools.js";
+import * as BlocksBlocksAPI from "../blocks/blocks.js";
+import * as GroupsGroupsAPI from "../groups/groups.js";
+import * as IdentitiesAPI from "../identities/identities.js";
+import * as ModelsAPI from "../models/models.js";
 import { APIPromise } from "../../core/api-promise.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;
+    tools: AgentsToolsAPI.Tools;
     folders: FoldersAPI.Folders;
     files: FilesAPI.Files;
-    coreMemory: CoreMemoryAPI.CoreMemory;
-    archivalMemory: ArchivalMemoryAPI.ArchivalMemory;
+    blocks: BlocksAPI.Blocks;
+    groups: GroupsAPI.Groups;
     messages: MessagesAPI.Messages;
     /**
      * Create an agent.
@@ -56,47 +55,13 @@ export declare class Agents extends APIResource {
     /**
      * 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 interface AgentEnvironmentVariable {
     /**
@@ -135,6 +100,10 @@ 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
@@ -160,6 +129,10 @@ export interface AgentState {
      * The type of agent.
      */
     agent_type: AgentType;
+    /**
+     * The memory blocks used by the agent.
+     */
+    blocks: Array<BlocksAPI.Block>;
     /**
      * The embedding configuration used by the agent.
      */
@@ -169,9 +142,9 @@ export interface AgentState {
      */
     llm_config: ModelsAPI.LlmConfig;
     /**
-     * The in-context memory of the agent.
+     * @deprecated The in-context memory of the agent.
      */
-    memory: CoreMemoryAPI.Memory;
+    memory: AgentState.Memory;
     /**
      * The name of the agent.
      */
@@ -179,7 +152,7 @@ export interface AgentState {
     /**
      * The sources used by the agent.
      */
-    sources: Array<SourcesSourcesAPI.Source>;
+    sources: Array<AgentState.Source>;
     /**
      * The system prompt used by the agent.
      */
@@ -191,7 +164,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.
      */
@@ -225,7 +198,11 @@ export interface AgentState {
      */
     hidden?: boolean | null;
     /**
-     * The ids of the identities associated with this agent.
+     * The identities associated with this agent.
+     */
+    identities?: Array<IdentitiesAPI.Identity>;
+    /**
+     * @deprecated The ids of the identities associated with this agent.
      */
     identity_ids?: Array<string>;
     /**
@@ -240,6 +217,10 @@ export interface AgentState {
      * 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 +243,9 @@ export interface AgentState {
         [key: string]: unknown;
     } | null;
     /**
-     * The multi-agent group that this agent manages
+     * @deprecated 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.
@@ -303,10 +284,181 @@ export interface AgentState {
      */
     updated_at?: string | null;
 }
+export declare namespace AgentState {
+    /**
+     * @deprecated 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;
+            /**
+             * 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;
+            /**
+             * The id of the template.
+             */
+            name?: string | 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;
+        }
+    }
+    /**
+     * 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.
+     */
+    interface Source {
+        /**
+         * The embedding configuration used by the source.
+         */
+        embedding_config: ModelsAPI.EmbeddingConfig;
+        /**
+         * The name of the source.
+         */
+        name: string;
+        /**
+         * The human-friendly ID of the Source
+         */
+        id?: 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?: ArchivesAPI.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';
 /**
  * A ToolRule represents a tool that can be invoked by the agent.
  */
@@ -319,12 +471,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.
  */
@@ -376,6 +555,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 +596,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
@@ -542,117 +734,16 @@ export interface TextResponseFormat {
 export type AgentListResponse = Array<AgentState>;
 export type AgentDeleteResponse = unknown;
 export type AgentCountResponse = number;
-export type AgentExportResponse = string;
+export type AgentExportFileResponse = string;
 /**
  * Response model for imported agents
  */
-export interface AgentImportResponse {
+export interface AgentImportFileResponse {
     /**
      * List of IDs of the imported agents
      */
     agent_ids: Array<string>;
 }
-export type AgentListGroupsResponse = Array<GroupsAPI.Group>;
-export interface AgentMigrateResponse {
-    success: true;
-}
-/**
- * Overview of the context window, including the number of messages and tokens.
- */
-export interface AgentRetrieveContextResponse {
-    /**
-     * The current number of tokens in the context window.
-     */
-    context_window_size_current: number;
-    /**
-     * The maximum amount of tokens the context window can hold.
-     */
-    context_window_size_max: number;
-    /**
-     * The content of the core memory.
-     */
-    core_memory: string;
-    /**
-     * The metadata summary of the external memory sources (archival + recall
-     * metadata).
-     */
-    external_memory_summary: string;
-    /**
-     * The content of the functions definitions.
-     */
-    functions_definitions: Array<AgentRetrieveContextResponse.FunctionsDefinition> | null;
-    /**
-     * The messages in the context window.
-     */
-    messages: Array<MessagesAPI.Message>;
-    /**
-     * The number of messages in the archival memory.
-     */
-    num_archival_memory: number;
-    /**
-     * The number of messages in the context window.
-     */
-    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;
-    /**
-     * The number of tokens in the external memory summary (archival + recall
-     * metadata).
-     */
-    num_tokens_external_memory_summary: number;
-    /**
-     * The number of tokens in the functions definitions.
-     */
-    num_tokens_functions_definitions: number;
-    /**
-     * The number of tokens in the messages list.
-     */
-    num_tokens_messages: number;
-    /**
-     * The number of tokens in the summary memory.
-     */
-    num_tokens_summary_memory: number;
-    /**
-     * The number of tokens in the system prompt.
-     */
-    num_tokens_system: number;
-    /**
-     * The content of the system prompt.
-     */
-    system_prompt: string;
-    /**
-     * The content of the summary memory.
-     */
-    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;
-}
 export interface AgentCreateParams {
     /**
      * Body param: The type of agent.
@@ -699,7 +790,8 @@ export interface AgentCreateParams {
      */
     enable_sleeptime?: boolean | null;
     /**
-     * Body param: The template id used to configure the agent
+     * Body param: Deprecated: please use the 'create agents from a template' endpoint
+     * instead.
      */
     from_template?: string | null;
     /**
@@ -757,7 +849,7 @@ export interface AgentCreateParams {
     /**
      * Body param: 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.
      */
@@ -785,6 +877,10 @@ export interface AgentCreateParams {
      * Body param: The name of the agent.
      */
     name?: string;
+    /**
+     * Body param: If set to True, enables parallel tool calling. Defaults to False.
+     */
+    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.
@@ -827,7 +923,7 @@ export interface AgentCreateParams {
      */
     tags?: Array<string> | null;
     /**
-     * Body param: Whether the agent is a template
+     * Body param: Deprecated: No longer used
      */
     template?: boolean;
     /**
@@ -862,10 +958,16 @@ export interface AgentCreateParams {
     '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,6 +980,10 @@ 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.
      */
@@ -920,6 +1026,11 @@ export interface AgentUpdateParams {
      * too high may exceed the context window, which will break the agent.
      */
     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.
+     */
+    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
@@ -945,6 +1056,10 @@ export interface AgentUpdateParams {
      * The name of the agent.
      */
     name?: string | null;
+    /**
+     * If set to True, enables parallel tool calling. Defaults to False.
+     */
+    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.
@@ -1029,10 +1144,16 @@ 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;
     /**
@@ -1079,21 +1200,26 @@ 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;
     /**
@@ -1111,6 +1237,10 @@ export interface AgentImportParams {
      * updated externally.
      */
     override_existing_tools?: boolean;
+    /**
+     * Body param: If provided, overrides the agent name with this value.
+     */
+    override_name?: string | null;
     /**
      * Body param: The project ID to associate the uploaded agent with.
      */
@@ -1124,76 +1254,13 @@ 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 { 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 AgentExportFileResponse as AgentExportFileResponse, type AgentImportFileResponse as AgentImportFileResponse, 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 { 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 { 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 { 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 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 MessageStreamResponse as MessageStreamResponse, type MessageUpdateParams as MessageUpdateParams, type MessageListParams as MessageListParams, type MessageCancelParams as MessageCancelParams, type MessageResetParams as MessageResetParams, type MessageSendParams as MessageSendParams, type MessageSendAsyncParams as MessageSendAsyncParams, type MessageStreamParams as MessageStreamParams, };
 }
 //# sourceMappingURL=agents.d.ts.map