@letta-ai/letta-client 1.0.0-alpha.20 → 1.0.0-alpha.22

package/src/resources/agents/agents.ts

@@ -84,8 +84,6 @@ import {
   MessageRole,
   MessageStreamParams,
   MessageType,
-  MessageUpdateParams,
-  MessageUpdateResponse,
   Messages,
   MessagesArrayPage,
   OmittedReasoningContent,
@@ -314,7 +312,8 @@ export interface AgentState {
   name: string;
 
   /**
-   * The sources used by the agent.
+   * @deprecated Deprecated: Use `folders` field instead. The sources used by the
+   * agent.
    */
   sources: Array<AgentState.Source>;
 
@@ -561,7 +560,8 @@ export namespace AgentState {
       is_open: boolean;
 
       /**
-       * Unique identifier of the source.
+       * @deprecated Deprecated: Use `folder_id` field instead. Unique identifier of the
+       * source.
        */
       source_id: string;
 
@@ -745,6 +745,11 @@ export interface AnthropicModelSettings {
    */
   max_output_tokens?: number;
 
+  /**
+   * The structured output format for the model.
+   */
+  output_format?: TextResponseFormat | JsonSchemaResponseFormat | JsonObjectResponseFormat | null;
+
   /**
    * Whether to enable parallel tool calling.
    */
@@ -1498,6 +1503,11 @@ export interface AgentCreateParams {
    */
   enable_sleeptime?: boolean | null;
 
+  /**
+   * 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.
@@ -1662,7 +1672,8 @@ export interface AgentCreateParams {
   secrets?: { [key: string]: string } | null;
 
   /**
-   * The ids of the sources used by the agent.
+   * @deprecated Deprecated: Use `folder_ids` field instead. The ids of the sources
+   * used by the agent.
    */
   source_ids?: Array<string> | null;
 
@@ -1784,6 +1795,11 @@ export interface AgentUpdateParams {
    */
   enable_sleeptime?: boolean | null;
 
+  /**
+   * The ids of the folders used by the agent.
+   */
+  folder_ids?: Array<string> | null;
+
   /**
    * If set to True, the agent will be hidden.
    */
@@ -1909,7 +1925,8 @@ export interface AgentUpdateParams {
   secrets?: { [key: string]: string } | null;
 
   /**
-   * The ids of the sources used by the agent.
+   * @deprecated Deprecated: Use `folder_ids` field instead. The ids of the sources
+   * used by the agent.
    */
   source_ids?: Array<string> | null;
 
@@ -2073,13 +2090,24 @@ export interface AgentImportFileParams {
   append_copy_suffix?: boolean;
 
   /**
-   * Body param: Environment variables as a JSON string to pass to the agent for tool
-   * execution.
+   * Body param: Embedding handle to override with.
+   */
+  embedding?: string | null;
+
+  /**
+   * @deprecated Body param: Environment variables as a JSON string to pass to the
+   * agent for tool execution. Use 'secrets' instead.
    */
   env_vars_json?: string | null;
 
   /**
-   * Body param: Override import with specific embedding handle.
+   * Body param: If provided, overrides the agent name with this value.
+   */
+  name?: string | null;
+
+  /**
+   * @deprecated Body param: Override import with specific embedding handle. Use
+   * 'embedding' instead.
    */
   override_embedding_handle?: string | null;
 
@@ -2091,15 +2119,22 @@ export interface AgentImportFileParams {
   override_existing_tools?: boolean;
 
   /**
-   * Body param: If provided, overrides the agent name with this value.
+   * @deprecated Body param: If provided, overrides the agent name with this value.
+   * Use 'name' instead.
    */
   override_name?: string | null;
 
   /**
-   * Body param: The project ID to associate the uploaded agent with.
+   * @deprecated Body param: The project ID to associate the uploaded agent with.
+   * This is now passed via headers.
    */
   project_id?: string | null;
 
+  /**
+   * Body param: Secrets as a JSON string to pass to the agent for tool execution.
+   */
+  secrets?: string | null;
+
   /**
    * Body param: If set to True, strips all messages from the agent before importing.
    */
@@ -2202,13 +2237,11 @@ export declare namespace Agents {
     type UpdateSystemMessage as UpdateSystemMessage,
     type UpdateUserMessage as UpdateUserMessage,
     type UserMessage as UserMessage,
-    type MessageUpdateResponse as MessageUpdateResponse,
     type MessageCancelResponse as MessageCancelResponse,
     type MessagesArrayPage as MessagesArrayPage,
     type MessageCreateParams as MessageCreateParams,
     type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
     type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
-    type MessageUpdateParams as MessageUpdateParams,
     type MessageListParams as MessageListParams,
     type MessageCancelParams as MessageCancelParams,
     type MessageCreateAsyncParams as MessageCreateAsyncParams,

package/src/resources/agents/folders.ts

@@ -31,7 +31,7 @@ export class Folders extends APIResource {
     folderID: string,
     params: FolderAttachParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
+  ): APIPromise<AgentsAPI.AgentState | null> {
     const { agent_id } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/folders/attach/${folderID}`, options);
   }
@@ -43,7 +43,7 @@ export class Folders extends APIResource {
     folderID: string,
     params: FolderDetachParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
+  ): APIPromise<AgentsAPI.AgentState | null> {
     const { agent_id } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/folders/detach/${folderID}`, options);
   }

package/src/resources/agents/index.ts

@@ -125,12 +125,10 @@ export {
   type UpdateSystemMessage,
   type UpdateUserMessage,
   type UserMessage,
-  type MessageUpdateResponse,
   type MessageCancelResponse,
   type MessageCreateParams,
   type MessageCreateParamsNonStreaming,
   type MessageCreateParamsStreaming,
-  type MessageUpdateParams,
   type MessageListParams,
   type MessageCancelParams,
   type MessageCreateAsyncParams,

package/src/resources/agents/messages.ts

@@ -56,18 +56,6 @@ export class Messages extends APIResource {
     }) as APIPromise<LettaResponse> | APIPromise<Stream<LettaStreamingResponse>>;
   }
 
-  /**
-   * Update the details of a message associated with an agent.
-   */
-  update(
-    messageID: string,
-    params: MessageUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<MessageUpdateResponse> {
-    const { agent_id, ...body } = params;
-    return this._client.patch(path`/v1/agents/${agent_id}/messages/${messageID}`, { body, ...options });
-  }
-
   /**
    * Retrieve message history for an agent.
    */
@@ -96,6 +84,16 @@ export class Messages extends APIResource {
     return this._client.post(path`/v1/agents/${agentID}/messages/cancel`, { body, ...options });
   }
 
+  /**
+   * Summarize an agent's conversation history.
+   */
+  compact(agentID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/v1/agents/${agentID}/summarize`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
   /**
    * Asynchronously process a user message and return a run object. The actual
    * processing happens in the background, and the status can be checked using the
@@ -115,7 +113,7 @@ export class Messages extends APIResource {
     agentID: string,
     body: MessageResetParams,
     options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
+  ): APIPromise<AgentsAPI.AgentState | null> {
     return this._client.patch(path`/v1/agents/${agentID}/reset-messages`, { body, ...options });
   }
 
@@ -135,16 +133,6 @@ export class Messages extends APIResource {
       stream: true,
     }) as APIPromise<Stream<LettaStreamingResponse>>;
   }
-
-  /**
-   * Summarize an agent's conversation history.
-   */
-  summarize(agentID: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/v1/agents/${agentID}/summarize`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
 }
 
 export type MessagesArrayPage = ArrayPage<Message>;
@@ -1709,27 +1697,6 @@ export interface UserMessage {
   step_id?: string | null;
 }
 
-/**
- * A message generated by the system. Never streamed back on a response, only used
- * for cursor pagination.
- *
- * Args: id (str): The ID of the message date (datetime): The date the message was
- * created in ISO format name (Optional[str]): The name of the sender of the
- * message content (str): The message content sent by the system
- */
-export type MessageUpdateResponse =
-  | SystemMessage
-  | UserMessage
-  | ReasoningMessage
-  | HiddenReasoningMessage
-  | ToolCallMessage
-  | ToolsAPI.ToolReturnMessage
-  | AssistantMessage
-  | ApprovalRequestMessage
-  | ApprovalResponseMessage
-  | SummaryMessage
-  | EventMessage;
-
 export type MessageCancelResponse = { [key: string]: unknown };
 
 export type MessageCreateParams = MessageCreateParamsNonStreaming | MessageCreateParamsStreaming;
@@ -1880,85 +1847,6 @@ export interface MessageCreateParamsStreaming extends MessageCreateParamsBase {
   streaming: true;
 }
 
-export type MessageUpdateParams =
-  | MessageUpdateParams.UpdateSystemMessage
-  | MessageUpdateParams.UpdateUserMessage
-  | MessageUpdateParams.UpdateReasoningMessage
-  | MessageUpdateParams.UpdateAssistantMessage;
-
-export declare namespace MessageUpdateParams {
-  export interface UpdateSystemMessage {
-    /**
-     * Path param: The ID of the agent in the format 'agent-<uuid4>'
-     */
-    agent_id: string;
-
-    /**
-     * Body param: The message content sent by the system (can be a string or an array
-     * of multi-modal content parts)
-     */
-    content: string;
-
-    /**
-     * Body param:
-     */
-    message_type?: 'system_message';
-  }
-
-  export interface UpdateUserMessage {
-    /**
-     * Path param: The ID of the agent in the format 'agent-<uuid4>'
-     */
-    agent_id: string;
-
-    /**
-     * Body param: The message content sent by the user (can be a string or an array of
-     * multi-modal content parts)
-     */
-    content: Array<LettaUserMessageContentUnion> | string;
-
-    /**
-     * Body param:
-     */
-    message_type?: 'user_message';
-  }
-
-  export interface UpdateReasoningMessage {
-    /**
-     * Path param: The ID of the agent in the format 'agent-<uuid4>'
-     */
-    agent_id: string;
-
-    /**
-     * Body param:
-     */
-    reasoning: string;
-
-    /**
-     * Body param:
-     */
-    message_type?: 'reasoning_message';
-  }
-
-  export interface UpdateAssistantMessage {
-    /**
-     * Path param: The ID of the agent in the format 'agent-<uuid4>'
-     */
-    agent_id: string;
-
-    /**
-     * Body param: The message content sent by the assistant (can be a string or an
-     * array of content parts)
-     */
-    content: Array<LettaAssistantMessageContentUnion> | string;
-
-    /**
-     * Body param:
-     */
-    message_type?: 'assistant_message';
-  }
-}
-
 export interface MessageListParams extends ArrayPageParams {
   /**
    * @deprecated The name of the message argument.
@@ -2277,13 +2165,11 @@ export declare namespace Messages {
     type UpdateSystemMessage as UpdateSystemMessage,
     type UpdateUserMessage as UpdateUserMessage,
     type UserMessage as UserMessage,
-    type MessageUpdateResponse as MessageUpdateResponse,
     type MessageCancelResponse as MessageCancelResponse,
     type MessagesArrayPage as MessagesArrayPage,
     type MessageCreateParams as MessageCreateParams,
     type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
     type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
-    type MessageUpdateParams as MessageUpdateParams,
     type MessageListParams as MessageListParams,
     type MessageCancelParams as MessageCancelParams,
     type MessageCreateAsyncParams as MessageCreateAsyncParams,

package/src/resources/archives/passages.ts

@@ -101,7 +101,8 @@ export interface PassageCreateResponse {
   metadata?: { [key: string]: unknown } | null;
 
   /**
-   * The data source of the passage.
+   * @deprecated Deprecated: Use `folder_id` field instead. The data source of the
+   * passage.
    */
   source_id?: string | null;
 

package/src/resources/folders/files.ts

@@ -63,7 +63,8 @@ export interface FileListResponse {
   id: string;
 
   /**
-   * The unique identifier of the source associated with the document.
+   * @deprecated Deprecated: Use `folder_id` field instead. The unique identifier of
+   * the source associated with the document.
    */
   source_id: string;
 
@@ -150,7 +151,8 @@ export interface FileUploadResponse {
   id: string;
 
   /**
-   * The unique identifier of the source associated with the document.
+   * @deprecated Deprecated: Use `folder_id` field instead. The unique identifier of
+   * the source associated with the document.
    */
   source_id: string;
 

package/src/resources/index.ts

@@ -120,7 +120,6 @@ export {
   type McpServerRetrieveResponse,
   type McpServerUpdateResponse,
   type McpServerListResponse,
-  type McpServerConnectResponse,
   type McpServerRefreshResponse,
   type McpServerCreateParams,
   type McpServerUpdateParams,

package/src/resources/mcp-servers/index.ts

@@ -17,7 +17,6 @@ export {
   type McpServerRetrieveResponse,
   type McpServerUpdateResponse,
   type McpServerListResponse,
-  type McpServerConnectResponse,
   type McpServerRefreshResponse,
   type McpServerCreateParams,
   type McpServerUpdateParams,