@letta-ai/letta-client 1.6.6 → 1.6.8

package/src/client.ts

@@ -41,6 +41,7 @@ import {
 import {
   MessageListParams,
   MessageListResponse,
+  MessageRetrieveResponse,
   MessageSearchParams,
   MessageSearchRequest,
   MessageSearchResponse,
@@ -117,14 +118,6 @@ import {
   ArchivesArrayPage,
   VectorDBProvider,
 } from './resources/archives/archives';
-import {
-  BatchCancelResponse,
-  BatchCreateParams,
-  BatchJob,
-  BatchJobsArrayPage,
-  BatchListParams,
-  Batches,
-} from './resources/batches/batches';
 import {
   BlockCreateParams,
   BlockDeleteResponse,
@@ -137,6 +130,7 @@ import {
 } from './resources/blocks/blocks';
 import {
   Conversation,
+  ConversationCancelResponse,
   ConversationCreateParams,
   ConversationListParams,
   ConversationListResponse,
@@ -152,33 +146,6 @@ import {
   Folders,
   FoldersArrayPage,
 } from './resources/folders/folders';
-import {
-  DynamicManager,
-  Group,
-  GroupCreateParams,
-  GroupDeleteResponse,
-  GroupListParams,
-  GroupUpdateParams,
-  Groups,
-  GroupsArrayPage,
-  ManagerType,
-  RoundRobinManager,
-  SleeptimeManager,
-  SupervisorManager,
-  VoiceSleeptimeManager,
-} from './resources/groups/groups';
-import {
-  Identities,
-  IdentitiesArrayPage,
-  Identity,
-  IdentityCreateParams,
-  IdentityDeleteResponse,
-  IdentityListParams,
-  IdentityProperty,
-  IdentityType,
-  IdentityUpdateParams,
-  IdentityUpsertParams,
-} from './resources/identities/identities';
 import {
   CreateSseMcpServer,
   CreateStdioMcpServer,
@@ -981,11 +948,8 @@ export class Letta {
   steps: API.Steps = new API.Steps(this);
   templates: API.Templates = new API.Templates(this);
   tags: API.Tags = new API.Tags(this);
-  identities: API.Identities = new API.Identities(this);
-  groups: API.Groups = new API.Groups(this);
   messages: API.Messages = new API.Messages(this);
   passages: API.Passages = new API.Passages(this);
-  batches: API.Batches = new API.Batches(this);
   conversations: API.Conversations = new API.Conversations(this);
   accessTokens: API.AccessTokens = new API.AccessTokens(this);
 }
@@ -1001,11 +965,8 @@ Letta.Runs = Runs;
 Letta.Steps = Steps;
 Letta.Templates = Templates;
 Letta.Tags = Tags;
-Letta.Identities = Identities;
-Letta.Groups = Groups;
 Letta.Messages = Messages;
 Letta.Passages = Passages;
-Letta.Batches = Batches;
 Letta.Conversations = Conversations;
 Letta.AccessTokens = AccessTokens;
 
@@ -1178,39 +1139,11 @@ export declare namespace Letta {
 
   export { Tags as Tags, type TagListResponse as TagListResponse, type TagListParams as TagListParams };
 
-  export {
-    Identities as Identities,
-    type Identity as Identity,
-    type IdentityProperty as IdentityProperty,
-    type IdentityType as IdentityType,
-    type IdentityDeleteResponse as IdentityDeleteResponse,
-    type IdentitiesArrayPage as IdentitiesArrayPage,
-    type IdentityCreateParams as IdentityCreateParams,
-    type IdentityUpdateParams as IdentityUpdateParams,
-    type IdentityListParams as IdentityListParams,
-    type IdentityUpsertParams as IdentityUpsertParams,
-  };
-
-  export {
-    Groups as Groups,
-    type DynamicManager as DynamicManager,
-    type Group as Group,
-    type ManagerType as ManagerType,
-    type RoundRobinManager as RoundRobinManager,
-    type SleeptimeManager as SleeptimeManager,
-    type SupervisorManager as SupervisorManager,
-    type VoiceSleeptimeManager as VoiceSleeptimeManager,
-    type GroupDeleteResponse as GroupDeleteResponse,
-    type GroupsArrayPage as GroupsArrayPage,
-    type GroupCreateParams as GroupCreateParams,
-    type GroupUpdateParams as GroupUpdateParams,
-    type GroupListParams as GroupListParams,
-  };
-
   export {
     Messages as Messages,
     type MessageSearchRequest as MessageSearchRequest,
     type MessageSearchResult as MessageSearchResult,
+    type MessageRetrieveResponse as MessageRetrieveResponse,
     type MessageListResponse as MessageListResponse,
     type MessageSearchResponse as MessageSearchResponse,
     type MessageListParams as MessageListParams,
@@ -1224,20 +1157,12 @@ export declare namespace Letta {
     type PassageSearchParams as PassageSearchParams,
   };
 
-  export {
-    Batches as Batches,
-    type BatchJob as BatchJob,
-    type BatchCancelResponse as BatchCancelResponse,
-    type BatchJobsArrayPage as BatchJobsArrayPage,
-    type BatchCreateParams as BatchCreateParams,
-    type BatchListParams as BatchListParams,
-  };
-
   export {
     Conversations as Conversations,
     type Conversation as Conversation,
     type CreateConversation as CreateConversation,
     type ConversationListResponse as ConversationListResponse,
+    type ConversationCancelResponse as ConversationCancelResponse,
     type ConversationCreateParams as ConversationCreateParams,
     type ConversationListParams as ConversationListParams,
   };

package/src/resources/agents/agents.ts

@@ -43,8 +43,6 @@ import {
   FolderListResponsesArrayPage,
   Folders,
 } from './folders';
-import * as GroupsAPI from './groups';
-import { GroupListParams, Groups } from './groups';
 import * as IdentitiesAPI from './identities';
 import {
   Identities,
@@ -120,18 +118,6 @@ import {
   PassageSearchResponse,
   Passages,
 } from './passages';
-import * as ScheduleAPI from './schedule';
-import {
-  Schedule,
-  ScheduleCreateParams,
-  ScheduleCreateResponse,
-  ScheduleDeleteParams,
-  ScheduleDeleteResponse,
-  ScheduleListParams,
-  ScheduleListResponse,
-  ScheduleRetrieveParams,
-  ScheduleRetrieveResponse,
-} from './schedule';
 import * as AgentsToolsAPI from './tools';
 import {
   ToolAttachParams,
@@ -145,8 +131,6 @@ import {
 } from './tools';
 import * as ArchivesArchivesAPI from '../archives/archives';
 import * as BlocksBlocksAPI from '../blocks/blocks';
-import * as GroupsGroupsAPI from '../groups/groups';
-import * as IdentitiesIdentitiesAPI from '../identities/identities';
 import * as ModelsAPI from '../models/models';
 import * as RunsAPI from '../runs/runs';
 import { APIPromise } from '../../core/api-promise';
@@ -159,12 +143,10 @@ import { path } from '../../internal/utils/path';
 
 export class Agents extends APIResource {
   messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
-  schedule: ScheduleAPI.Schedule = new ScheduleAPI.Schedule(this._client);
   blocks: BlocksAPI.Blocks = new BlocksAPI.Blocks(this._client);
   tools: AgentsToolsAPI.Tools = new AgentsToolsAPI.Tools(this._client);
   folders: FoldersAPI.Folders = new FoldersAPI.Folders(this._client);
   files: FilesAPI.Files = new FilesAPI.Files(this._client);
-  groups: GroupsAPI.Groups = new GroupsAPI.Groups(this._client);
   archives: ArchivesAPI.Archives = new ArchivesAPI.Archives(this._client);
   passages: PassagesAPI.Passages = new PassagesAPI.Passages(this._client);
   identities: IdentitiesAPI.Identities = new IdentitiesAPI.Identities(this._client);
@@ -426,7 +408,7 @@ export interface AgentState {
   /**
    * The identities associated with this agent.
    */
-  identities?: Array<IdentitiesIdentitiesAPI.Identity>;
+  identities?: Array<AgentState.Identity>;
 
   /**
    * @deprecated Deprecated: Use `identities` field instead. The ids of the
@@ -457,7 +439,7 @@ export interface AgentState {
   /**
    * The multi-agent group that this agent manages
    */
-  managed_group?: GroupsGroupsAPI.Group | null;
+  managed_group?: AgentState.ManagedGroup | null;
 
   /**
    * Maximum number of files that can be open at once for this agent. Setting this
@@ -508,7 +490,7 @@ export interface AgentState {
    * @deprecated Deprecated: Use `managed_group` field instead. The multi-agent group
    * that this agent manages.
    */
-  multi_agent_group?: GroupsGroupsAPI.Group | null;
+  multi_agent_group?: AgentState.MultiAgentGroup | null;
 
   /**
    * A message representing a request for approval to call a tool (generated by the
@@ -881,6 +863,141 @@ export namespace AgentState {
     }
   }
 
+  export interface Identity {
+    /**
+     * The human-friendly ID of the Identity
+     */
+    id: string;
+
+    /**
+     * @deprecated The IDs of the agents associated with the identity.
+     */
+    agent_ids: Array<string>;
+
+    /**
+     * @deprecated The IDs of the blocks associated with the identity.
+     */
+    block_ids: Array<string>;
+
+    /**
+     * External, user-generated identifier key of the identity.
+     */
+    identifier_key: string;
+
+    /**
+     * The type of the identity.
+     */
+    identity_type: 'org' | 'user' | 'other';
+
+    /**
+     * The name of the identity.
+     */
+    name: string;
+
+    /**
+     * The project id of the identity, if applicable.
+     */
+    project_id?: string | null;
+
+    /**
+     * List of properties associated with the identity
+     */
+    properties?: Array<Identity.Property>;
+  }
+
+  export namespace Identity {
+    /**
+     * A property of an identity
+     */
+    export interface Property {
+      /**
+       * The key of the property
+       */
+      key: string;
+
+      /**
+       * The type of the property
+       */
+      type: 'string' | 'number' | 'boolean' | 'json';
+
+      /**
+       * The value of the property
+       */
+      value: string | number | boolean | { [key: string]: unknown };
+    }
+  }
+
+  /**
+   * The multi-agent group that this agent manages
+   */
+  export interface ManagedGroup {
+    /**
+     * The id of the group. Assigned by the database.
+     */
+    id: string;
+
+    agent_ids: Array<string>;
+
+    description: string;
+
+    manager_type: 'round_robin' | 'supervisor' | 'dynamic' | 'sleeptime' | 'voice_sleeptime' | 'swarm';
+
+    /**
+     * The base template id.
+     */
+    base_template_id?: string | null;
+
+    /**
+     * The id of the deployment.
+     */
+    deployment_id?: string | null;
+
+    /**
+     * If set to True, the group will be hidden.
+     */
+    hidden?: boolean | null;
+
+    last_processed_message_id?: string | null;
+
+    manager_agent_id?: string | null;
+
+    /**
+     * The desired maximum length of messages in the context window of the convo agent.
+     * This is a best effort, and may be off slightly due to user/assistant
+     * interleaving.
+     */
+    max_message_buffer_length?: number | null;
+
+    max_turns?: number | null;
+
+    /**
+     * The desired minimum length of messages in the context window of the convo agent.
+     * This is a best effort, and may be off-by-one due to user/assistant interleaving.
+     */
+    min_message_buffer_length?: number | null;
+
+    /**
+     * The associated project id.
+     */
+    project_id?: string | null;
+
+    /**
+     * @deprecated
+     */
+    shared_block_ids?: Array<string>;
+
+    sleeptime_agent_frequency?: number | null;
+
+    /**
+     * The id of the template.
+     */
+    template_id?: string | null;
+
+    termination_token?: string | null;
+
+    turns_counter?: number | null;
+  }
+
   /**
    * Z.ai (ZhipuAI) model configuration (OpenAI-compatible).
    */
@@ -914,6 +1031,78 @@ export namespace AgentState {
      */
     temperature?: number;
   }
+
+  /**
+   * @deprecated Deprecated: Use `managed_group` field instead. The multi-agent group
+   * that this agent manages.
+   */
+  export interface MultiAgentGroup {
+    /**
+     * The id of the group. Assigned by the database.
+     */
+    id: string;
+
+    agent_ids: Array<string>;
+
+    description: string;
+
+    manager_type: 'round_robin' | 'supervisor' | 'dynamic' | 'sleeptime' | 'voice_sleeptime' | 'swarm';
+
+    /**
+     * The base template id.
+     */
+    base_template_id?: string | null;
+
+    /**
+     * The id of the deployment.
+     */
+    deployment_id?: string | null;
+
+    /**
+     * If set to True, the group will be hidden.
+     */
+    hidden?: boolean | null;
+
+    last_processed_message_id?: string | null;
+
+    manager_agent_id?: string | null;
+
+    /**
+     * The desired maximum length of messages in the context window of the convo agent.
+     * This is a best effort, and may be off slightly due to user/assistant
+     * interleaving.
+     */
+    max_message_buffer_length?: number | null;
+
+    max_turns?: number | null;
+
+    /**
+     * The desired minimum length of messages in the context window of the convo agent.
+     * This is a best effort, and may be off-by-one due to user/assistant interleaving.
+     */
+    min_message_buffer_length?: number | null;
+
+    /**
+     * The associated project id.
+     */
+    project_id?: string | null;
+
+    /**
+     * @deprecated
+     */
+    shared_block_ids?: Array<string>;
+
+    sleeptime_agent_frequency?: number | null;
+
+    /**
+     * The id of the template.
+     */
+    template_id?: string | null;
+
+    termination_token?: string | null;
+
+    turns_counter?: number | null;
+  }
 }
 
 /**
@@ -2629,12 +2818,10 @@ export interface AgentImportFileParams {
 }
 
 Agents.Messages = Messages;
-Agents.Schedule = Schedule;
 Agents.Blocks = Blocks;
 Agents.Tools = Tools;
 Agents.Folders = Folders;
 Agents.Files = Files;
-Agents.Groups = Groups;
 Agents.Archives = Archives;
 Agents.Passages = Passages;
 Agents.Identities = Identities;
@@ -2735,18 +2922,6 @@ export declare namespace Agents {
     type MessageStreamParams as MessageStreamParams,
   };
 
-  export {
-    Schedule as Schedule,
-    type ScheduleCreateResponse as ScheduleCreateResponse,
-    type ScheduleRetrieveResponse as ScheduleRetrieveResponse,
-    type ScheduleListResponse as ScheduleListResponse,
-    type ScheduleDeleteResponse as ScheduleDeleteResponse,
-    type ScheduleCreateParams as ScheduleCreateParams,
-    type ScheduleRetrieveParams as ScheduleRetrieveParams,
-    type ScheduleListParams as ScheduleListParams,
-    type ScheduleDeleteParams as ScheduleDeleteParams,
-  };
-
   export {
     Blocks as Blocks,
     type Block as Block,
@@ -2790,8 +2965,6 @@ export declare namespace Agents {
     type FileOpenParams as FileOpenParams,
   };
 
-  export { Groups as Groups, type GroupListParams as GroupListParams };
-
   export {
     Archives as Archives,
     type ArchiveAttachResponse as ArchiveAttachResponse,

package/src/resources/agents/index.ts

@@ -76,7 +76,6 @@ export {
   type FolderDetachParams,
   type FolderListResponsesArrayPage,
 } from './folders';
-export { Groups, type GroupListParams } from './groups';
 export {
   Identities,
   type IdentityAttachResponse,
@@ -138,7 +137,6 @@ export {
   type MessageStreamParams,
   type RunsArrayPage,
   type MessagesArrayPage,
-  type InternalMessagesObjectPage,
 } from './messages';
 export {
   Passages,
@@ -151,17 +149,6 @@ export {
   type PassageDeleteParams,
   type PassageSearchParams,
 } from './passages';
-export {
-  Schedule,
-  type ScheduleCreateResponse,
-  type ScheduleRetrieveResponse,
-  type ScheduleListResponse,
-  type ScheduleDeleteResponse,
-  type ScheduleCreateParams,
-  type ScheduleRetrieveParams,
-  type ScheduleListParams,
-  type ScheduleDeleteParams,
-} from './schedule';
 export {
   Tools,
   type ToolExecuteRequest,

package/src/resources/agents/messages.ts

@@ -6,7 +6,7 @@ import * as ToolsAPI from '../tools';
 import * as AgentsAPI from './agents';
 import * as RunsAPI from '../runs/runs';
 import { APIPromise } from '../../core/api-promise';
-import { ArrayPage, type ArrayPageParams, ObjectPage, PagePromise } from '../../core/pagination';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -146,8 +146,6 @@ export type MessagesArrayPage = ArrayPage<Message>;
 
 export type RunsArrayPage = ArrayPage<Run>;
 
-export type InternalMessagesObjectPage = ObjectPage<InternalMessage>;
-
 /**
  * Input to approve or deny a tool call request
  */

package/src/resources/conversations/conversations.ts

@@ -5,7 +5,6 @@ import * as MessagesAPI from './messages';
 import {
   MessageCreateParams,
   MessageListParams,
-  MessageListResponse,
   MessageStreamParams,
   MessageStreamResponse,
   Messages,
@@ -38,6 +37,15 @@ export class Conversations extends APIResource {
   list(query: ConversationListParams, options?: RequestOptions): APIPromise<ConversationListResponse> {
     return this._client.get('/v1/conversations/', { query, ...options });
   }
+
+  /**
+   * Cancel runs associated with a conversation.
+   *
+   * Note: To cancel active runs, Redis is required.
+   */
+  cancel(conversationID: string, options?: RequestOptions): APIPromise<ConversationCancelResponse> {
+    return this._client.post(path`/v1/conversations/${conversationID}/cancel`, options);
+  }
 }
 
 /**
@@ -110,6 +118,8 @@ export interface CreateConversation {
 
 export type ConversationListResponse = Array<Conversation>;
 
+export type ConversationCancelResponse = { [key: string]: unknown };
+
 export interface ConversationCreateParams {
   /**
    * Query param: The agent ID to create a conversation for
@@ -153,13 +163,13 @@ export declare namespace Conversations {
     type Conversation as Conversation,
     type CreateConversation as CreateConversation,
     type ConversationListResponse as ConversationListResponse,
+    type ConversationCancelResponse as ConversationCancelResponse,
     type ConversationCreateParams as ConversationCreateParams,
     type ConversationListParams as ConversationListParams,
   };
 
   export {
     Messages as Messages,
-    type MessageListResponse as MessageListResponse,
     type MessageStreamResponse as MessageStreamResponse,
     type MessageCreateParams as MessageCreateParams,
     type MessageListParams as MessageListParams,

package/src/resources/conversations/index.ts

@@ -5,12 +5,12 @@ export {
   type Conversation,
   type CreateConversation,
   type ConversationListResponse,
+  type ConversationCancelResponse,
   type ConversationCreateParams,
   type ConversationListParams,
 } from './conversations';
 export {
   Messages,
-  type MessageListResponse,
   type MessageStreamResponse,
   type MessageCreateParams,
   type MessageListParams,

package/src/resources/conversations/messages.ts

@@ -3,7 +3,9 @@
 import { APIResource } from '../../core/resource';
 import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from '../agents/messages';
+import { MessagesArrayPage } from '../agents/messages';
 import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { Stream } from '../../core/streaming';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -31,15 +33,18 @@ export class Messages extends APIResource {
    * List all messages in a conversation.
    *
    * Returns LettaMessage objects (UserMessage, AssistantMessage, etc.) for all
-   * messages in the conversation, ordered by position (oldest first), with support
-   * for cursor-based pagination.
+   * messages in the conversation, with support for cursor-based pagination.
    */
   list(
     conversationID: string,
     query: MessageListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<MessageListResponse> {
-    return this._client.get(path`/v1/conversations/${conversationID}/messages`, { query, ...options });
+  ): PagePromise<MessagesArrayPage, MessagesAPI.Message> {
+    return this._client.getAPIList(
+      path`/v1/conversations/${conversationID}/messages`,
+      ArrayPage<MessagesAPI.Message>,
+      { query, ...options },
+    );
   }
 
   /**
@@ -61,8 +66,6 @@ export class Messages extends APIResource {
   }
 }
 
-export type MessageListResponse = Array<MessagesAPI.Message>;
-
 export type MessageStreamResponse = unknown;
 
 export interface MessageCreateParams {
@@ -223,23 +226,17 @@ export namespace MessageCreateParams {
   }
 }
 
-export interface MessageListParams {
+export interface MessageListParams extends ArrayPageParams {
   /**
-   * Message ID cursor for pagination. Returns messages that come after this message
-   * ID in the conversation
+   * Group ID to filter messages by.
    */
-  after?: string | null;
+  group_id?: string | null;
 
   /**
-   * Message ID cursor for pagination. Returns messages that come before this message
-   * ID in the conversation
+   * Whether to include error messages and error statuses. For debugging purposes
+   * only.
    */
-  before?: string | null;
-
-  /**
-   * Maximum number of messages to return
-   */
-  limit?: number | null;
+  include_err?: boolean | null;
 }
 
 export interface MessageStreamParams {
@@ -268,10 +265,11 @@ export interface MessageStreamParams {
 
 export declare namespace Messages {
   export {
-    type MessageListResponse as MessageListResponse,
     type MessageStreamResponse as MessageStreamResponse,
     type MessageCreateParams as MessageCreateParams,
     type MessageListParams as MessageListParams,
     type MessageStreamParams as MessageStreamParams,
   };
 }
+
+export { type MessagesArrayPage };