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

package/src/resources/groups/messages.ts

@@ -13,49 +13,49 @@ import { path } from '../../internal/utils/path';
 
 export class Messages extends APIResource {
   /**
-   * Retrieve message history for an agent.
+   * Process a user message and return the group's response. This endpoint accepts a
+   * message from a user and processes it through through agents in the group based
+   * on the specified pattern
    */
-  list(
+  create(
     groupID: string,
-    query: MessageListParams | null | undefined = {},
+    body: MessageCreateParams,
     options?: RequestOptions,
-  ): PagePromise<MessagesArrayPage, MessagesAPI.Message> {
-    return this._client.getAPIList(path`/v1/groups/${groupID}/messages`, ArrayPage<MessagesAPI.Message>, {
-      query,
-      ...options,
-    });
+  ): APIPromise<MessagesAPI.LettaResponse> {
+    return this._client.post(path`/v1/groups/${groupID}/messages`, { body, ...options });
   }
 
   /**
    * Update the details of a message associated with an agent.
    */
-  modify(
+  update(
     messageID: string,
-    params: MessageModifyParams,
+    params: MessageUpdateParams,
     options?: RequestOptions,
-  ): APIPromise<MessageModifyResponse> {
+  ): APIPromise<MessageUpdateResponse> {
     const { group_id, ...body } = params;
     return this._client.patch(path`/v1/groups/${group_id}/messages/${messageID}`, { body, ...options });
   }
 
   /**
-   * Delete the group messages for all agents that are part of the multi-agent group.
+   * Retrieve message history for an agent.
    */
-  reset(groupID: string, options?: RequestOptions): APIPromise<unknown> {
-    return this._client.patch(path`/v1/groups/${groupID}/reset-messages`, options);
+  list(
+    groupID: string,
+    query: MessageListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<MessagesArrayPage, MessagesAPI.Message> {
+    return this._client.getAPIList(path`/v1/groups/${groupID}/messages`, ArrayPage<MessagesAPI.Message>, {
+      query,
+      ...options,
+    });
   }
 
   /**
-   * Process a user message and return the group's response. This endpoint accepts a
-   * message from a user and processes it through through agents in the group based
-   * on the specified pattern
+   * Delete the group messages for all agents that are part of the multi-agent group.
    */
-  send(
-    groupID: string,
-    body: MessageSendParams,
-    options?: RequestOptions,
-  ): APIPromise<MessagesAPI.LettaResponse> {
-    return this._client.post(path`/v1/groups/${groupID}/messages`, { body, ...options });
+  reset(groupID: string, options?: RequestOptions): APIPromise<unknown> {
+    return this._client.patch(path`/v1/groups/${groupID}/reset-messages`, options);
   }
 
   /**
@@ -85,7 +85,7 @@ export class Messages extends APIResource {
  * 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 =
   | MessagesAPI.SystemMessage
   | MessagesAPI.UserMessage
   | MessagesAPI.ReasoningMessage
@@ -102,103 +102,7 @@ export type MessageResetResponse = unknown;
 
 export type MessageStreamResponse = unknown;
 
-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;
-
-  /**
-   * @deprecated Whether to use assistant messages
-   */
-  use_assistant_message?: boolean;
-}
-
-export type MessageModifyParams =
-  | MessageModifyParams.UpdateSystemMessage
-  | MessageModifyParams.UpdateUserMessage
-  | MessageModifyParams.UpdateReasoningMessage
-  | MessageModifyParams.UpdateAssistantMessage;
-
-export declare namespace MessageModifyParams {
-  export interface UpdateSystemMessage {
-    /**
-     * Path param: The ID of the group in the format 'group-<uuid4>'
-     */
-    group_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 group in the format 'group-<uuid4>'
-     */
-    group_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<MessagesAPI.LettaUserMessageContentUnion> | string;
-
-    /**
-     * Body param:
-     */
-    message_type?: 'user_message';
-  }
-
-  export interface UpdateReasoningMessage {
-    /**
-     * Path param: The ID of the group in the format 'group-<uuid4>'
-     */
-    group_id: string;
-
-    /**
-     * Body param:
-     */
-    reasoning: string;
-
-    /**
-     * Body param:
-     */
-    message_type?: 'reasoning_message';
-  }
-
-  export interface UpdateAssistantMessage {
-    /**
-     * Path param: The ID of the group in the format 'group-<uuid4>'
-     */
-    group_id: string;
-
-    /**
-     * Body param: The message content sent by the assistant (can be a string or an
-     * array of content parts)
-     */
-    content: Array<MessagesAPI.LettaAssistantMessageContentUnion> | string;
-
-    /**
-     * Body param:
-     */
-    message_type?: 'assistant_message';
-  }
-}
-
-export interface MessageSendParams {
+export interface MessageCreateParams {
   /**
    * @deprecated The name of the message argument in the designated message tool.
    * Still supported for legacy agent types, but deprecated for letta_v1_agent
@@ -238,7 +142,7 @@ export interface MessageSendParams {
         | MessagesAPI.ReasoningContent
         | MessagesAPI.RedactedReasoningContent
         | MessagesAPI.OmittedReasoningContent
-        | MessageSendParams.SummarizedReasoningContent
+        | MessageCreateParams.SummarizedReasoningContent
       >
     | null;
 
@@ -260,7 +164,7 @@ export interface MessageSendParams {
   use_assistant_message?: boolean;
 }
 
-export namespace MessageSendParams {
+export namespace MessageCreateParams {
   /**
    * The style of reasoning content returned by the OpenAI Responses API
    */
@@ -301,6 +205,102 @@ export namespace MessageSendParams {
   }
 }
 
+export type MessageUpdateParams =
+  | MessageUpdateParams.UpdateSystemMessage
+  | MessageUpdateParams.UpdateUserMessage
+  | MessageUpdateParams.UpdateReasoningMessage
+  | MessageUpdateParams.UpdateAssistantMessage;
+
+export declare namespace MessageUpdateParams {
+  export interface UpdateSystemMessage {
+    /**
+     * Path param: The ID of the group in the format 'group-<uuid4>'
+     */
+    group_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 group in the format 'group-<uuid4>'
+     */
+    group_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<MessagesAPI.LettaUserMessageContentUnion> | string;
+
+    /**
+     * Body param:
+     */
+    message_type?: 'user_message';
+  }
+
+  export interface UpdateReasoningMessage {
+    /**
+     * Path param: The ID of the group in the format 'group-<uuid4>'
+     */
+    group_id: string;
+
+    /**
+     * Body param:
+     */
+    reasoning: string;
+
+    /**
+     * Body param:
+     */
+    message_type?: 'reasoning_message';
+  }
+
+  export interface UpdateAssistantMessage {
+    /**
+     * Path param: The ID of the group in the format 'group-<uuid4>'
+     */
+    group_id: string;
+
+    /**
+     * Body param: The message content sent by the assistant (can be a string or an
+     * array of content parts)
+     */
+    content: Array<MessagesAPI.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;
+
+  /**
+   * @deprecated Whether to use assistant messages
+   */
+  use_assistant_message?: boolean;
+}
+
 export interface MessageStreamParams {
   /**
    * @deprecated The name of the message argument in the designated message tool.
@@ -430,12 +430,12 @@ export namespace MessageStreamParams {
 
 export declare namespace Messages {
   export {
-    type MessageModifyResponse as MessageModifyResponse,
+    type MessageUpdateResponse as MessageUpdateResponse,
     type MessageResetResponse as MessageResetResponse,
     type MessageStreamResponse as MessageStreamResponse,
+    type MessageCreateParams as MessageCreateParams,
+    type MessageUpdateParams as MessageUpdateParams,
     type MessageListParams as MessageListParams,
-    type MessageModifyParams as MessageModifyParams,
-    type MessageSendParams as MessageSendParams,
     type MessageStreamParams as MessageStreamParams,
   };
 }

package/src/resources/identities/identities.ts

@@ -31,6 +31,13 @@ export class Identities extends APIResource {
     return this._client.get(path`/v1/identities/${identityID}`, options);
   }
 
+  /**
+   * Update Identity
+   */
+  update(identityID: string, body: IdentityUpdateParams, options?: RequestOptions): APIPromise<Identity> {
+    return this._client.patch(path`/v1/identities/${identityID}`, { body, ...options });
+  }
+
   /**
    * Get a list of all identities in the database
    */
@@ -48,13 +55,6 @@ export class Identities extends APIResource {
     return this._client.delete(path`/v1/identities/${identityID}`, options);
   }
 
-  /**
-   * Modify Identity
-   */
-  modify(identityID: string, body: IdentityModifyParams, options?: RequestOptions): APIPromise<Identity> {
-    return this._client.patch(path`/v1/identities/${identityID}`, { body, ...options });
-  }
-
   /**
    * Upsert Identity
    */
@@ -171,20 +171,7 @@ export interface IdentityCreateParams {
   properties?: Array<IdentityProperty> | null;
 }
 
-export interface IdentityListParams extends ArrayPageParams {
-  identifier_key?: string | null;
-
-  /**
-   * Enum to represent the type of the identity.
-   */
-  identity_type?: IdentityType | null;
-
-  name?: string | null;
-
-  project_id?: string | null;
-}
-
-export interface IdentityModifyParams {
+export interface IdentityUpdateParams {
   /**
    * @deprecated The agent ids that are associated with the identity.
    */
@@ -216,6 +203,19 @@ export interface IdentityModifyParams {
   properties?: Array<IdentityProperty> | null;
 }
 
+export interface IdentityListParams extends ArrayPageParams {
+  identifier_key?: string | null;
+
+  /**
+   * Enum to represent the type of the identity.
+   */
+  identity_type?: IdentityType | null;
+
+  name?: string | null;
+
+  project_id?: string | null;
+}
+
 export interface IdentityUpsertParams {
   /**
    * External, user-generated identifier key of the identity.
@@ -265,8 +265,8 @@ export declare namespace Identities {
     type IdentityDeleteResponse as IdentityDeleteResponse,
     type IdentitiesArrayPage as IdentitiesArrayPage,
     type IdentityCreateParams as IdentityCreateParams,
+    type IdentityUpdateParams as IdentityUpdateParams,
     type IdentityListParams as IdentityListParams,
-    type IdentityModifyParams as IdentityModifyParams,
     type IdentityUpsertParams as IdentityUpsertParams,
   };
 

package/src/resources/identities/index.ts

@@ -9,8 +9,8 @@ export {
   type IdentityType,
   type IdentityDeleteResponse,
   type IdentityCreateParams,
+  type IdentityUpdateParams,
   type IdentityListParams,
-  type IdentityModifyParams,
   type IdentityUpsertParams,
   type IdentitiesArrayPage,
 } from './identities';

package/src/resources/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/agents';
 export {
@@ -45,8 +45,8 @@ export {
   type Archive,
   type VectorDBProvider,
   type ArchiveCreateParams,
+  type ArchiveUpdateParams,
   type ArchiveListParams,
-  type ArchiveModifyParams,
   type ArchivesArrayPage,
 } from './archives/archives';
 export {
@@ -63,8 +63,8 @@ export {
   type CreateBlock,
   type BlockDeleteResponse,
   type BlockCreateParams,
+  type BlockUpdateParams,
   type BlockListParams,
-  type BlockModifyParams,
   type BlockResponsesArrayPage,
 } from './blocks/blocks';
 export {
@@ -72,8 +72,8 @@ export {
   type Folder,
   type FolderDeleteResponse,
   type FolderCreateParams,
+  type FolderUpdateParams,
   type FolderListParams,
-  type FolderModifyParams,
   type FoldersArrayPage,
 } from './folders/folders';
 export {
@@ -87,8 +87,8 @@ export {
   type VoiceSleeptimeManager,
   type GroupDeleteResponse,
   type GroupCreateParams,
+  type GroupUpdateParams,
   type GroupListParams,
-  type GroupModifyParams,
   type GroupsArrayPage,
 } from './groups/groups';
 export {
@@ -98,8 +98,8 @@ export {
   type IdentityType,
   type IdentityDeleteResponse,
   type IdentityCreateParams,
+  type IdentityUpdateParams,
   type IdentityListParams,
-  type IdentityModifyParams,
   type IdentityUpsertParams,
   type IdentitiesArrayPage,
 } from './identities/identities';
@@ -118,12 +118,12 @@ export {
   type UpdateStreamableHTTPMcpServer,
   type McpServerCreateResponse,
   type McpServerRetrieveResponse,
+  type McpServerUpdateResponse,
   type McpServerListResponse,
   type McpServerConnectResponse,
-  type McpServerModifyResponse,
   type McpServerRefreshResponse,
   type McpServerCreateParams,
-  type McpServerModifyParams,
+  type McpServerUpdateParams,
   type McpServerRefreshParams,
 } from './mcp-servers/mcp-servers';
 export {
@@ -158,8 +158,8 @@ export {
   type ToolDeleteResponse,
   type ToolUpsertBaseToolsResponse,
   type ToolCreateParams,
+  type ToolUpdateParams,
   type ToolListParams,
-  type ToolModifyParams,
   type ToolUpsertParams,
   type ToolsArrayPage,
 } from './tools';

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

@@ -15,12 +15,12 @@ export {
   type UpdateStreamableHTTPMcpServer,
   type McpServerCreateResponse,
   type McpServerRetrieveResponse,
+  type McpServerUpdateResponse,
   type McpServerListResponse,
   type McpServerConnectResponse,
-  type McpServerModifyResponse,
   type McpServerRefreshResponse,
   type McpServerCreateParams,
-  type McpServerModifyParams,
+  type McpServerUpdateParams,
   type McpServerRefreshParams,
 } from './mcp-servers';
 export { Tools, type ToolListResponse, type ToolRetrieveParams, type ToolRunParams } from './tools';

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

@@ -26,6 +26,17 @@ export class McpServers extends APIResource {
     return this._client.get(path`/v1/mcp-servers/${mcpServerID}`, options);
   }
 
+  /**
+   * Update an existing MCP server configuration
+   */
+  update(
+    mcpServerID: string,
+    body: McpServerUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<McpServerUpdateResponse> {
+    return this._client.patch(path`/v1/mcp-servers/${mcpServerID}`, { body, ...options });
+  }
+
   /**
    * Get a list of all configured MCP servers
    */
@@ -51,17 +62,6 @@ export class McpServers extends APIResource {
     return this._client.get(path`/v1/mcp-servers/connect/${mcpServerID}`, options);
   }
 
-  /**
-   * Update an existing MCP server configuration
-   */
-  modify(
-    mcpServerID: string,
-    body: McpServerModifyParams,
-    options?: RequestOptions,
-  ): APIPromise<McpServerModifyResponse> {
-    return this._client.patch(path`/v1/mcp-servers/${mcpServerID}`, { body, ...options });
-  }
-
   /**
    * Refresh tools for an MCP server by:
    *
@@ -431,14 +431,14 @@ export type McpServerCreateResponse = StdioMcpServer | SseMcpServer | Streamable
  */
 export type McpServerRetrieveResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
 
-export type McpServerListResponse = Array<StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer>;
-
-export type McpServerConnectResponse = unknown;
-
 /**
  * A Stdio MCP server
  */
-export type McpServerModifyResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
+export type McpServerUpdateResponse = StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer;
+
+export type McpServerListResponse = Array<StdioMcpServer | SseMcpServer | StreamableHTTPMcpServer>;
+
+export type McpServerConnectResponse = unknown;
 
 export type McpServerRefreshResponse = unknown;
 
@@ -531,12 +531,12 @@ export declare namespace McpServerCreateParams {
   }
 }
 
-export type McpServerModifyParams =
-  | McpServerModifyParams.UpdateStdioMcpServer
-  | McpServerModifyParams.UpdateSseMcpServer
-  | McpServerModifyParams.UpdateStreamableHTTPMcpServer;
+export type McpServerUpdateParams =
+  | McpServerUpdateParams.UpdateStdioMcpServer
+  | McpServerUpdateParams.UpdateSseMcpServer
+  | McpServerUpdateParams.UpdateStreamableHTTPMcpServer;
 
-export declare namespace McpServerModifyParams {
+export declare namespace McpServerUpdateParams {
   export interface UpdateStdioMcpServer {
     /**
      * The arguments to pass to the command
@@ -645,12 +645,12 @@ export declare namespace McpServers {
     type UpdateStreamableHTTPMcpServer as UpdateStreamableHTTPMcpServer,
     type McpServerCreateResponse as McpServerCreateResponse,
     type McpServerRetrieveResponse as McpServerRetrieveResponse,
+    type McpServerUpdateResponse as McpServerUpdateResponse,
     type McpServerListResponse as McpServerListResponse,
     type McpServerConnectResponse as McpServerConnectResponse,
-    type McpServerModifyResponse as McpServerModifyResponse,
     type McpServerRefreshResponse as McpServerRefreshResponse,
     type McpServerCreateParams as McpServerCreateParams,
-    type McpServerModifyParams as McpServerModifyParams,
+    type McpServerUpdateParams as McpServerUpdateParams,
     type McpServerRefreshParams as McpServerRefreshParams,
   };
 

package/src/resources/models/models.ts

@@ -198,6 +198,11 @@ export interface EmbeddingModel {
 
 /**
  * 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.
  */
 export interface LlmConfig {
   /**