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

package/src/resources/agents/blocks.ts

@@ -22,6 +22,21 @@ export class Blocks extends APIResource {
     return this._client.get(path`/v1/agents/${agent_id}/core-memory/blocks/${blockLabel}`, options);
   }
 
+  /**
+   * Updates a core memory block of an agent.
+   */
+  update(
+    blockLabel: string,
+    params: BlockUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<BlocksBlocksAPI.BlockResponse> {
+    const { agent_id, ...body } = params;
+    return this._client.patch(path`/v1/agents/${agent_id}/core-memory/blocks/${blockLabel}`, {
+      body,
+      ...options,
+    });
+  }
+
   /**
    * Retrieve the core memory blocks of a specific agent.
    */
@@ -60,21 +75,6 @@ export class Blocks extends APIResource {
     const { agent_id } = params;
     return this._client.patch(path`/v1/agents/${agent_id}/core-memory/blocks/detach/${blockID}`, options);
   }
-
-  /**
-   * Updates a core memory block of an agent.
-   */
-  modify(
-    blockLabel: string,
-    params: BlockModifyParams,
-    options?: RequestOptions,
-  ): APIPromise<BlocksBlocksAPI.BlockResponse> {
-    const { agent_id, ...body } = params;
-    return this._client.patch(path`/v1/agents/${agent_id}/core-memory/blocks/${blockLabel}`, {
-      body,
-      ...options,
-    });
-  }
 }
 
 /**
@@ -175,7 +175,7 @@ export interface Block {
 /**
  * Update a block
  */
-export interface BlockModify {
+export interface BlockUpdate {
   /**
    * The base template id of the block.
    */
@@ -259,23 +259,7 @@ export interface BlockRetrieveParams {
   agent_id: string;
 }
 
-export interface BlockListParams extends ArrayPageParams {}
-
-export interface BlockAttachParams {
-  /**
-   * The ID of the agent in the format 'agent-<uuid4>'
-   */
-  agent_id: string;
-}
-
-export interface BlockDetachParams {
-  /**
-   * The ID of the agent in the format 'agent-<uuid4>'
-   */
-  agent_id: string;
-}
-
-export interface BlockModifyParams {
+export interface BlockUpdateParams {
   /**
    * Path param: The ID of the agent in the format 'agent-<uuid4>'
    */
@@ -357,15 +341,31 @@ export interface BlockModifyParams {
   value?: string | null;
 }
 
+export interface BlockListParams extends ArrayPageParams {}
+
+export interface BlockAttachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+}
+
+export interface BlockDetachParams {
+  /**
+   * The ID of the agent in the format 'agent-<uuid4>'
+   */
+  agent_id: string;
+}
+
 export declare namespace Blocks {
   export {
     type Block as Block,
-    type BlockModify as BlockModify,
+    type BlockUpdate as BlockUpdate,
     type BlockRetrieveParams as BlockRetrieveParams,
+    type BlockUpdateParams as BlockUpdateParams,
     type BlockListParams as BlockListParams,
     type BlockAttachParams as BlockAttachParams,
     type BlockDetachParams as BlockDetachParams,
-    type BlockModifyParams as BlockModifyParams,
   };
 }
 

package/src/resources/agents/index.ts

@@ -34,10 +34,10 @@ export {
   type AgentImportFileResponse,
   type AgentCreateParams,
   type AgentRetrieveParams,
+  type AgentUpdateParams,
   type AgentListParams,
   type AgentExportFileParams,
   type AgentImportFileParams,
-  type AgentModifyParams,
   type AgentStatesArrayPage,
 } from './agents';
 export {
@@ -50,12 +50,12 @@ export {
 export {
   Blocks,
   type Block,
-  type BlockModify,
+  type BlockUpdate,
   type BlockRetrieveParams,
+  type BlockUpdateParams,
   type BlockListParams,
   type BlockAttachParams,
   type BlockDetachParams,
-  type BlockModifyParams,
 } from './blocks';
 export {
   Files,
@@ -125,16 +125,16 @@ export {
   type UpdateSystemMessage,
   type UpdateUserMessage,
   type UserMessage,
+  type MessageUpdateResponse,
   type MessageCancelResponse,
-  type MessageModifyResponse,
+  type MessageCreateParams,
+  type MessageCreateParamsNonStreaming,
+  type MessageCreateParamsStreaming,
+  type MessageUpdateParams,
   type MessageListParams,
   type MessageCancelParams,
-  type MessageModifyParams,
+  type MessageCreateAsyncParams,
   type MessageResetParams,
-  type MessageSendParams,
-  type MessageSendParamsNonStreaming,
-  type MessageSendParamsStreaming,
-  type MessageSendAsyncParams,
   type MessageStreamParams,
   type RunsArrayPage,
   type MessagesArrayPage,

package/src/resources/agents/messages.ts

@@ -13,57 +13,6 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Messages extends APIResource {
-  /**
-   * Retrieve message history for an agent.
-   */
-  list(
-    agentID: string,
-    query: MessageListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<MessagesArrayPage, Message> {
-    return this._client.getAPIList(path`/v1/agents/${agentID}/messages`, ArrayPage<Message>, {
-      query,
-      ...options,
-    });
-  }
-
-  /**
-   * Cancel runs associated with an agent. If run_ids are passed in, cancel those in
-   * particular.
-   *
-   * Note to cancel active runs associated with an agent, redis is required.
-   */
-  cancel(
-    agentID: string,
-    body: MessageCancelParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<MessageCancelResponse> {
-    return this._client.post(path`/v1/agents/${agentID}/messages/cancel`, { body, ...options });
-  }
-
-  /**
-   * Update the details of a message associated with an agent.
-   */
-  modify(
-    messageID: string,
-    params: MessageModifyParams,
-    options?: RequestOptions,
-  ): APIPromise<MessageModifyResponse> {
-    const { agent_id, ...body } = params;
-    return this._client.patch(path`/v1/agents/${agent_id}/messages/${messageID}`, { body, ...options });
-  }
-
-  /**
-   * Resets the messages for an agent
-   */
-  reset(
-    agentID: string,
-    body: MessageResetParams,
-    options?: RequestOptions,
-  ): APIPromise<AgentsAPI.AgentState> {
-    return this._client.patch(path`/v1/agents/${agentID}/reset-messages`, { body, ...options });
-  }
-
   /**
    * Process a user message and return the agent's response. This endpoint accepts a
    * message from a user and processes it through the agent.
@@ -80,24 +29,24 @@ export class Messages extends APIResource {
    * - `include_pings`: Include keepalive pings to prevent connection timeouts
    * - `background`: Process the request in the background
    */
-  send(
+  create(
     agentID: string,
-    body: MessageSendParamsNonStreaming,
+    body: MessageCreateParamsNonStreaming,
     options?: RequestOptions,
   ): APIPromise<LettaResponse>;
-  send(
+  create(
     agentID: string,
-    body: MessageSendParamsStreaming,
+    body: MessageCreateParamsStreaming,
     options?: RequestOptions,
   ): APIPromise<Stream<LettaStreamingResponse>>;
-  send(
+  create(
     agentID: string,
-    body: MessageSendParamsBase,
+    body: MessageCreateParamsBase,
     options?: RequestOptions,
   ): APIPromise<Stream<LettaStreamingResponse> | LettaResponse>;
-  send(
+  create(
     agentID: string,
-    body: MessageSendParams,
+    body: MessageCreateParams,
     options?: RequestOptions,
   ): APIPromise<LettaResponse> | APIPromise<Stream<LettaStreamingResponse>> {
     return this._client.post(path`/v1/agents/${agentID}/messages`, {
@@ -107,6 +56,46 @@ 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.
+   */
+  list(
+    agentID: string,
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<MessagesArrayPage, Message> {
+    return this._client.getAPIList(path`/v1/agents/${agentID}/messages`, ArrayPage<Message>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Cancel runs associated with an agent. If run_ids are passed in, cancel those in
+   * particular.
+   *
+   * Note to cancel active runs associated with an agent, redis is required.
+   */
+  cancel(
+    agentID: string,
+    body: MessageCancelParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageCancelResponse> {
+    return this._client.post(path`/v1/agents/${agentID}/messages/cancel`, { body, ...options });
+  }
+
   /**
    * 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,10 +104,21 @@ export class Messages extends APIResource {
    * This is "asynchronous" in the sense that it's a background run and explicitly
    * must be fetched by the run ID.
    */
-  sendAsync(agentID: string, body: MessageSendAsyncParams, options?: RequestOptions): APIPromise<Run> {
+  createAsync(agentID: string, body: MessageCreateAsyncParams, options?: RequestOptions): APIPromise<Run> {
     return this._client.post(path`/v1/agents/${agentID}/messages/async`, { body, ...options });
   }
 
+  /**
+   * Resets the messages for an agent
+   */
+  reset(
+    agentID: string,
+    body: MessageResetParams,
+    options?: RequestOptions,
+  ): APIPromise<AgentsAPI.AgentState> {
+    return this._client.patch(path`/v1/agents/${agentID}/reset-messages`, { body, ...options });
+  }
+
   /**
    * Process a user message and return the agent's response. This endpoint accepts a
    * message from a user and processes it through the agent. It will stream the steps
@@ -1709,8 +1709,6 @@ export interface UserMessage {
   step_id?: string | null;
 }
 
-export type MessageCancelResponse = { [key: string]: unknown };
-
 /**
  * A message generated by the system. Never streamed back on a response, only used
  * for cursor pagination.
@@ -1719,7 +1717,7 @@ export type MessageCancelResponse = { [key: string]: unknown };
  * 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 MessageModifyResponse =
+export type MessageUpdateResponse =
   | SystemMessage
   | UserMessage
   | ReasoningMessage
@@ -1732,130 +1730,11 @@ export type MessageModifyResponse =
   | SummaryMessage
   | EventMessage;
 
-export interface MessageListParams extends ArrayPageParams {
-  /**
-   * @deprecated The name of the message argument.
-   */
-  assistant_message_tool_kwarg?: string;
-
-  /**
-   * @deprecated The name of the designated message tool.
-   */
-  assistant_message_tool_name?: string;
-
-  /**
-   * Group ID to filter messages by.
-   */
-  group_id?: string | null;
-
-  /**
-   * Whether to include error messages and error statuses. For debugging purposes
-   * only.
-   */
-  include_err?: boolean | null;
-
-  /**
-   * @deprecated Whether to use assistant messages
-   */
-  use_assistant_message?: boolean;
-}
-
-export interface MessageCancelParams {
-  /**
-   * Optional list of run IDs to cancel
-   */
-  run_ids?: Array<string> | null;
-}
-
-export type MessageModifyParams =
-  | MessageModifyParams.UpdateSystemMessage
-  | MessageModifyParams.UpdateUserMessage
-  | MessageModifyParams.UpdateReasoningMessage
-  | MessageModifyParams.UpdateAssistantMessage;
-
-export declare namespace MessageModifyParams {
-  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 MessageResetParams {
-  /**
-   * If true, adds the default initial messages after resetting.
-   */
-  add_default_initial_messages?: boolean;
-}
+export type MessageCancelResponse = { [key: string]: unknown };
 
-export type MessageSendParams = MessageSendParamsNonStreaming | MessageSendParamsStreaming;
+export type MessageCreateParams = MessageCreateParamsNonStreaming | MessageCreateParamsStreaming;
 
-export interface MessageSendParamsBase {
+export interface MessageCreateParamsBase {
   /**
    * @deprecated The name of the message argument in the designated message tool.
    * Still supported for legacy agent types, but deprecated for letta_v1_agent
@@ -1907,7 +1786,7 @@ export interface MessageSendParamsBase {
         | ReasoningContent
         | RedactedReasoningContent
         | OmittedReasoningContent
-        | MessageSendParams.SummarizedReasoningContent
+        | MessageCreateParams.SummarizedReasoningContent
       >
     | null;
 
@@ -1941,7 +1820,7 @@ export interface MessageSendParamsBase {
   use_assistant_message?: boolean;
 }
 
-export namespace MessageSendParams {
+export namespace MessageCreateParams {
   /**
    * The style of reasoning content returned by the OpenAI Responses API
    */
@@ -1981,11 +1860,11 @@ export namespace MessageSendParams {
     }
   }
 
-  export type MessageSendParamsNonStreaming = MessagesAPI.MessageSendParamsNonStreaming;
-  export type MessageSendParamsStreaming = MessagesAPI.MessageSendParamsStreaming;
+  export type MessageCreateParamsNonStreaming = MessagesAPI.MessageCreateParamsNonStreaming;
+  export type MessageCreateParamsStreaming = MessagesAPI.MessageCreateParamsStreaming;
 }
 
-export interface MessageSendParamsNonStreaming extends MessageSendParamsBase {
+export interface MessageCreateParamsNonStreaming extends MessageCreateParamsBase {
   /**
    * If True, returns a streaming response (Server-Sent Events). If False (default),
    * returns a complete response.
@@ -1993,7 +1872,7 @@ export interface MessageSendParamsNonStreaming extends MessageSendParamsBase {
   streaming?: false;
 }
 
-export interface MessageSendParamsStreaming extends MessageSendParamsBase {
+export interface MessageCreateParamsStreaming extends MessageCreateParamsBase {
   /**
    * If True, returns a streaming response (Server-Sent Events). If False (default),
    * returns a complete response.
@@ -2001,7 +1880,121 @@ export interface MessageSendParamsStreaming extends MessageSendParamsBase {
   streaming: true;
 }
 
-export interface MessageSendAsyncParams {
+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.
+   */
+  assistant_message_tool_kwarg?: string;
+
+  /**
+   * @deprecated The name of the designated message tool.
+   */
+  assistant_message_tool_name?: string;
+
+  /**
+   * Group ID to filter messages by.
+   */
+  group_id?: string | null;
+
+  /**
+   * Whether to include error messages and error statuses. For debugging purposes
+   * only.
+   */
+  include_err?: boolean | null;
+
+  /**
+   * @deprecated Whether to use assistant messages
+   */
+  use_assistant_message?: boolean;
+}
+
+export interface MessageCancelParams {
+  /**
+   * Optional list of run IDs to cancel
+   */
+  run_ids?: Array<string> | null;
+}
+
+export interface MessageCreateAsyncParams {
   /**
    * @deprecated The name of the message argument in the designated message tool.
    * Still supported for legacy agent types, but deprecated for letta_v1_agent
@@ -2046,7 +2039,7 @@ export interface MessageSendAsyncParams {
         | ReasoningContent
         | RedactedReasoningContent
         | OmittedReasoningContent
-        | MessageSendAsyncParams.SummarizedReasoningContent
+        | MessageCreateAsyncParams.SummarizedReasoningContent
       >
     | null;
 
@@ -2068,7 +2061,7 @@ export interface MessageSendAsyncParams {
   use_assistant_message?: boolean;
 }
 
-export namespace MessageSendAsyncParams {
+export namespace MessageCreateAsyncParams {
   /**
    * The style of reasoning content returned by the OpenAI Responses API
    */
@@ -2109,6 +2102,13 @@ export namespace MessageSendAsyncParams {
   }
 }
 
+export interface MessageResetParams {
+  /**
+   * If true, adds the default initial messages after resetting.
+   */
+  add_default_initial_messages?: boolean;
+}
+
 export interface MessageStreamParams {
   /**
    * @deprecated The name of the message argument in the designated message tool.
@@ -2277,17 +2277,17 @@ 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 MessageModifyResponse as MessageModifyResponse,
     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 MessageModifyParams as MessageModifyParams,
+    type MessageCreateAsyncParams as MessageCreateAsyncParams,
     type MessageResetParams as MessageResetParams,
-    type MessageSendParams as MessageSendParams,
-    type MessageSendParamsNonStreaming as MessageSendParamsNonStreaming,
-    type MessageSendParamsStreaming as MessageSendParamsStreaming,
-    type MessageSendAsyncParams as MessageSendAsyncParams,
     type MessageStreamParams as MessageStreamParams,
   };
 }