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

package/src/resources/folders/files.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { type Uploadable } from '../../core/uploads';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
@@ -16,8 +17,11 @@ export class Files extends APIResource {
     folderID: string,
     query: FileListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FileListResponse> {
-    return this._client.get(path`/v1/folders/${folderID}/files`, { query, ...options });
+  ): PagePromise<FileListResponsesArrayPage, FileListResponse> {
+    return this._client.getAPIList(path`/v1/folders/${folderID}/files`, ArrayPage<FileListResponse>, {
+      query,
+      ...options,
+    });
   }
 
   /**
@@ -47,110 +51,22 @@ export class Files extends APIResource {
   }
 }
 
-export type FileListResponse = Array<FileListResponse.FileListResponseItem>;
-
-export namespace FileListResponse {
-  /**
-   * Representation of a single FileMetadata
-   */
-  export interface FileListResponseItem {
-    /**
-     * The unique identifier of the source associated with the document.
-     */
-    source_id: string;
-
-    /**
-     * The human-friendly ID of the File
-     */
-    id?: string;
-
-    /**
-     * Number of chunks that have been embedded.
-     */
-    chunks_embedded?: number | null;
-
-    /**
-     * Optional full-text content of the file; only populated on demand due to its
-     * size.
-     */
-    content?: string | null;
-
-    /**
-     * The creation date of the file.
-     */
-    created_at?: string | null;
-
-    /**
-     * Optional error message if the file failed processing.
-     */
-    error_message?: string | null;
-
-    /**
-     * The creation date of the file.
-     */
-    file_creation_date?: string | null;
-
-    /**
-     * The last modified date of the file.
-     */
-    file_last_modified_date?: string | null;
-
-    /**
-     * The name of the file.
-     */
-    file_name?: string | null;
-
-    /**
-     * The path to the file.
-     */
-    file_path?: string | null;
-
-    /**
-     * The size of the file in bytes.
-     */
-    file_size?: number | null;
-
-    /**
-     * The type of the file (MIME type).
-     */
-    file_type?: string | null;
-
-    /**
-     * The original name of the file as uploaded.
-     */
-    original_file_name?: string | null;
-
-    /**
-     * The current processing status of the file (e.g. pending, parsing, embedding,
-     * completed, error).
-     */
-    processing_status?: 'pending' | 'parsing' | 'embedding' | 'completed' | 'error';
-
-    /**
-     * Total number of chunks for the file.
-     */
-    total_chunks?: number | null;
-
-    /**
-     * The update date of the file.
-     */
-    updated_at?: string | null;
-  }
-}
+export type FileListResponsesArrayPage = ArrayPage<FileListResponse>;
 
 /**
  * Representation of a single FileMetadata
  */
-export interface FileUploadResponse {
+export interface FileListResponse {
   /**
-   * The unique identifier of the source associated with the document.
+   * The human-friendly ID of the File
    */
-  source_id: string;
+  id: string;
 
   /**
-   * The human-friendly ID of the File
+   * @deprecated Deprecated: Use `folder_id` field instead. The unique identifier of
+   * the source associated with the document.
    */
-  id?: string;
+  source_id: string;
 
   /**
    * Number of chunks that have been embedded.
@@ -225,39 +141,99 @@ export interface FileUploadResponse {
   updated_at?: string | null;
 }
 
-export interface FileListParams {
+/**
+ * Representation of a single FileMetadata
+ */
+export interface FileUploadResponse {
   /**
-   * File ID cursor for pagination. Returns files that come after this file ID in the
-   * specified sort order
+   * The human-friendly ID of the File
    */
-  after?: string | null;
+  id: string;
 
   /**
-   * File ID cursor for pagination. Returns files that come before this file ID in
-   * the specified sort order
+   * @deprecated Deprecated: Use `folder_id` field instead. The unique identifier of
+   * the source associated with the document.
    */
-  before?: string | null;
+  source_id: string;
 
   /**
-   * Whether to include full file content
+   * Number of chunks that have been embedded.
    */
-  include_content?: boolean;
+  chunks_embedded?: number | null;
+
+  /**
+   * Optional full-text content of the file; only populated on demand due to its
+   * size.
+   */
+  content?: string | null;
 
   /**
-   * Maximum number of files to return
+   * The creation date of the file.
    */
-  limit?: number | null;
+  created_at?: string | null;
 
   /**
-   * Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
+   * Optional error message if the file failed processing.
    */
-  order?: 'asc' | 'desc';
+  error_message?: string | null;
 
   /**
-   * Field to sort by
+   * The creation date of the file.
    */
-  order_by?: 'created_at';
+  file_creation_date?: string | null;
+
+  /**
+   * The last modified date of the file.
+   */
+  file_last_modified_date?: string | null;
+
+  /**
+   * The name of the file.
+   */
+  file_name?: string | null;
+
+  /**
+   * The path to the file.
+   */
+  file_path?: string | null;
+
+  /**
+   * The size of the file in bytes.
+   */
+  file_size?: number | null;
+
+  /**
+   * The type of the file (MIME type).
+   */
+  file_type?: string | null;
+
+  /**
+   * The original name of the file as uploaded.
+   */
+  original_file_name?: string | null;
+
+  /**
+   * The current processing status of the file (e.g. pending, parsing, embedding,
+   * completed, error).
+   */
+  processing_status?: 'pending' | 'parsing' | 'embedding' | 'completed' | 'error';
+
+  /**
+   * Total number of chunks for the file.
+   */
+  total_chunks?: number | null;
+
+  /**
+   * The update date of the file.
+   */
+  updated_at?: string | null;
+}
+
+export interface FileListParams extends ArrayPageParams {
+  /**
+   * Whether to include full file content
+   */
+  include_content?: boolean;
 }
 
 export interface FileDeleteParams {
@@ -288,6 +264,7 @@ export declare namespace Files {
   export {
     type FileListResponse as FileListResponse,
     type FileUploadResponse as FileUploadResponse,
+    type FileListResponsesArrayPage as FileListResponsesArrayPage,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileUploadParams as FileUploadParams,

package/src/resources/folders/folders.ts

@@ -8,12 +8,14 @@ import {
   FileDeleteParams,
   FileListParams,
   FileListResponse,
+  FileListResponsesArrayPage,
   FileUploadParams,
   FileUploadResponse,
   Files,
 } from './files';
 import * as ModelsAPI from '../models/models';
 import { APIPromise } from '../../core/api-promise';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -48,8 +50,8 @@ export class Folders extends APIResource {
   list(
     query: FolderListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<FolderListResponse> {
-    return this._client.get('/v1/folders/', { query, ...options });
+  ): PagePromise<FoldersArrayPage, Folder> {
+    return this._client.getAPIList('/v1/folders/', ArrayPage<Folder>, { query, ...options });
   }
 
   /**
@@ -58,25 +60,19 @@ export class Folders extends APIResource {
   delete(folderID: string, options?: RequestOptions): APIPromise<unknown> {
     return this._client.delete(path`/v1/folders/${folderID}`, options);
   }
-
-  /**
-   * Count all data folders created by a user.
-   */
-  count(options?: RequestOptions): APIPromise<FolderCountResponse> {
-    return this._client.get('/v1/folders/count', options);
-  }
 }
 
+export type FoldersArrayPage = ArrayPage<Folder>;
+
 /**
  * Representation of a folder, which is a collection of files and passages.
- *
- * Parameters: id (str): The ID of the folder name (str): The name of the folder.
- * embedding_config (EmbeddingConfig): The embedding configuration used by the
- * folder. user_id (str): The ID of the user that created the folder. metadata
- * (dict): Metadata associated with the folder. description (str): The description
- * of the folder.
  */
 export interface Folder {
+  /**
+   * The human-friendly ID of the Source
+   */
+  id: string;
+
   /**
    * The embedding configuration used by the folder.
    */
@@ -87,11 +83,6 @@ export interface Folder {
    */
   name: string;
 
-  /**
-   * The human-friendly ID of the Source
-   */
-  id?: string;
-
   /**
    * The timestamp when the folder was created.
    */
@@ -128,12 +119,8 @@ export interface Folder {
   updated_at?: string | null;
 }
 
-export type FolderListResponse = Array<Folder>;
-
 export type FolderDeleteResponse = unknown;
 
-export type FolderCountResponse = number;
-
 export interface FolderCreateParams {
   /**
    * The name of the source.
@@ -198,39 +185,11 @@ export interface FolderUpdateParams {
   name?: string | null;
 }
 
-export interface FolderListParams {
-  /**
-   * Folder ID cursor for pagination. Returns folders that come after this folder ID
-   * in the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Folder ID cursor for pagination. Returns folders that come before this folder ID
-   * in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of folders to return
-   */
-  limit?: number | null;
-
+export interface FolderListParams extends ArrayPageParams {
   /**
    * Folder name to filter by
    */
   name?: string | null;
-
-  /**
-   * Sort order for folders by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
 }
 
 Folders.Files = Files;
@@ -239,9 +198,8 @@ Folders.Agents = Agents;
 export declare namespace Folders {
   export {
     type Folder as Folder,
-    type FolderListResponse as FolderListResponse,
     type FolderDeleteResponse as FolderDeleteResponse,
-    type FolderCountResponse as FolderCountResponse,
+    type FoldersArrayPage as FoldersArrayPage,
     type FolderCreateParams as FolderCreateParams,
     type FolderUpdateParams as FolderUpdateParams,
     type FolderListParams as FolderListParams,
@@ -251,6 +209,7 @@ export declare namespace Folders {
     Files as Files,
     type FileListResponse as FileListResponse,
     type FileUploadResponse as FileUploadResponse,
+    type FileListResponsesArrayPage as FileListResponsesArrayPage,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileUploadParams as FileUploadParams,

package/src/resources/folders/index.ts

@@ -8,14 +8,14 @@ export {
   type FileListParams,
   type FileDeleteParams,
   type FileUploadParams,
+  type FileListResponsesArrayPage,
 } from './files';
 export {
   Folders,
   type Folder,
-  type FolderListResponse,
   type FolderDeleteResponse,
-  type FolderCountResponse,
   type FolderCreateParams,
   type FolderUpdateParams,
   type FolderListParams,
+  type FoldersArrayPage,
 } from './folders';

package/src/resources/groups/groups.ts

@@ -3,10 +3,9 @@
 import { APIResource } from '../../core/resource';
 import * as MessagesAPI from './messages';
 import {
+  MessageCreateParams,
   MessageListParams,
-  MessageListResponse,
   MessageResetResponse,
-  MessageSendParams,
   MessageStreamParams,
   MessageStreamResponse,
   MessageUpdateParams,
@@ -14,7 +13,7 @@ import {
   Messages,
 } from './messages';
 import { APIPromise } from '../../core/api-promise';
-import { buildHeaders } from '../../internal/headers';
+import { ArrayPage, type ArrayPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -24,16 +23,8 @@ export class Groups extends APIResource {
   /**
    * Create a new multi-agent group with the specified configuration.
    */
-  create(params: GroupCreateParams, options?: RequestOptions): APIPromise<Group> {
-    const { 'X-Project': xProject, ...body } = params;
-    return this._client.post('/v1/groups/', {
-      body,
-      ...options,
-      headers: buildHeaders([
-        { ...(xProject != null ? { 'X-Project': xProject } : undefined) },
-        options?.headers,
-      ]),
-    });
+  create(body: GroupCreateParams, options?: RequestOptions): APIPromise<Group> {
+    return this._client.post('/v1/groups/', { body, ...options });
   }
 
   /**
@@ -46,16 +37,8 @@ export class Groups extends APIResource {
   /**
    * Create a new multi-agent group with the specified configuration.
    */
-  update(groupID: string, params: GroupUpdateParams, options?: RequestOptions): APIPromise<Group> {
-    const { 'X-Project': xProject, ...body } = params;
-    return this._client.patch(path`/v1/groups/${groupID}`, {
-      body,
-      ...options,
-      headers: buildHeaders([
-        { ...(xProject != null ? { 'X-Project': xProject } : undefined) },
-        options?.headers,
-      ]),
-    });
+  update(groupID: string, body: GroupUpdateParams, options?: RequestOptions): APIPromise<Group> {
+    return this._client.patch(path`/v1/groups/${groupID}`, { body, ...options });
   }
 
   /**
@@ -64,8 +47,8 @@ export class Groups extends APIResource {
   list(
     query: GroupListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<GroupListResponse> {
-    return this._client.get('/v1/groups/', { query, ...options });
+  ): PagePromise<GroupsArrayPage, Group> {
+    return this._client.getAPIList('/v1/groups/', ArrayPage<Group>, { query, ...options });
   }
 
   /**
@@ -74,15 +57,10 @@ export class Groups extends APIResource {
   delete(groupID: string, options?: RequestOptions): APIPromise<unknown> {
     return this._client.delete(path`/v1/groups/${groupID}`, options);
   }
-
-  /**
-   * Get the count of all groups associated with a given user.
-   */
-  count(options?: RequestOptions): APIPromise<GroupCountResponse> {
-    return this._client.get('/v1/groups/count', options);
-  }
 }
 
+export type GroupsArrayPage = ArrayPage<Group>;
+
 export interface DynamicManager {
   manager_agent_id: string;
 
@@ -144,6 +122,9 @@ export interface Group {
    */
   project_id?: string | null;
 
+  /**
+   * @deprecated
+   */
   shared_block_ids?: Array<string>;
 
   sleeptime_agent_frequency?: number | null;
@@ -205,31 +186,18 @@ export interface VoiceSleeptimeManager {
   min_message_buffer_length?: number | null;
 }
 
-export type GroupListResponse = Array<Group>;
-
 export type GroupDeleteResponse = unknown;
 
-export type GroupCountResponse = number;
-
 export interface GroupCreateParams {
-  /**
-   * Body param:
-   */
   agent_ids: Array<string>;
 
-  /**
-   * Body param:
-   */
   description: string;
 
   /**
-   * Body param: If set to True, the group will be hidden.
+   * If set to True, the group will be hidden.
    */
   hidden?: boolean | null;
 
-  /**
-   * Body param:
-   */
   manager_config?:
     | RoundRobinManager
     | SupervisorManager
@@ -238,35 +206,21 @@ export interface GroupCreateParams {
     | VoiceSleeptimeManager;
 
   /**
-   * Body param: The associated project id.
+   * The associated project id.
    */
   project_id?: string | null;
 
   /**
-   * Body param:
+   * @deprecated
    */
   shared_block_ids?: Array<string>;
-
-  /**
-   * Header param: The project slug to associate with the group (cloud only).
-   */
-  'X-Project'?: string;
 }
 
 export interface GroupUpdateParams {
-  /**
-   * Body param:
-   */
   agent_ids?: Array<string> | null;
 
-  /**
-   * Body param:
-   */
   description?: string | null;
 
-  /**
-   * Body param:
-   */
   manager_config?:
     | GroupUpdateParams.RoundRobinManagerUpdate
     | GroupUpdateParams.SupervisorManagerUpdate
@@ -276,19 +230,14 @@ export interface GroupUpdateParams {
     | null;
 
   /**
-   * Body param: The associated project id.
+   * The associated project id.
    */
   project_id?: string | null;
 
   /**
-   * Body param:
+   * @deprecated
    */
   shared_block_ids?: Array<string> | null;
-
-  /**
-   * Header param: The project slug to associate with the group (cloud only).
-   */
-  'X-Project'?: string;
 }
 
 export namespace GroupUpdateParams {
@@ -342,40 +291,12 @@ export namespace GroupUpdateParams {
   }
 }
 
-export interface GroupListParams {
-  /**
-   * Group ID cursor for pagination. Returns groups that come after this group ID in
-   * the specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Group ID cursor for pagination. Returns groups that come before this group ID in
-   * the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of groups to return
-   */
-  limit?: number | null;
-
+export interface GroupListParams extends ArrayPageParams {
   /**
    * Search groups by manager type
    */
   manager_type?: ManagerType | null;
 
-  /**
-   * Sort order for groups by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-
   /**
    * Search groups by project id
    */
@@ -393,9 +314,8 @@ export declare namespace Groups {
     type SleeptimeManager as SleeptimeManager,
     type SupervisorManager as SupervisorManager,
     type VoiceSleeptimeManager as VoiceSleeptimeManager,
-    type GroupListResponse as GroupListResponse,
     type GroupDeleteResponse as GroupDeleteResponse,
-    type GroupCountResponse as GroupCountResponse,
+    type GroupsArrayPage as GroupsArrayPage,
     type GroupCreateParams as GroupCreateParams,
     type GroupUpdateParams as GroupUpdateParams,
     type GroupListParams as GroupListParams,
@@ -404,12 +324,11 @@ export declare namespace Groups {
   export {
     Messages as Messages,
     type MessageUpdateResponse as MessageUpdateResponse,
-    type MessageListResponse as MessageListResponse,
     type MessageResetResponse as MessageResetResponse,
     type MessageStreamResponse as MessageStreamResponse,
+    type MessageCreateParams as MessageCreateParams,
     type MessageUpdateParams as MessageUpdateParams,
     type MessageListParams as MessageListParams,
-    type MessageSendParams as MessageSendParams,
     type MessageStreamParams as MessageStreamParams,
   };
 }

package/src/resources/groups/index.ts

@@ -9,21 +9,19 @@ export {
   type SleeptimeManager,
   type SupervisorManager,
   type VoiceSleeptimeManager,
-  type GroupListResponse,
   type GroupDeleteResponse,
-  type GroupCountResponse,
   type GroupCreateParams,
   type GroupUpdateParams,
   type GroupListParams,
+  type GroupsArrayPage,
 } from './groups';
 export {
   Messages,
   type MessageUpdateResponse,
-  type MessageListResponse,
   type MessageResetResponse,
   type MessageStreamResponse,
+  type MessageCreateParams,
   type MessageUpdateParams,
   type MessageListParams,
-  type MessageSendParams,
   type MessageStreamParams,
 } from './messages';