@letta-ai/letta-client 1.0.0-alpha.15 → 1.0.0-alpha.16

package/src/resources/batches/batches.ts

@@ -4,9 +4,10 @@ import { APIResource } from '../../core/resource';
 import * as AgentsAPI from '../agents/agents';
 import * as MessagesAPI from '../agents/messages';
 import * as BatchesMessagesAPI from './messages';
-import { MessageListParams, MessageListResponse, Messages } from './messages';
+import { MessageListParams, Messages } from './messages';
 import * as RunsAPI from '../runs/runs';
 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';
 
@@ -36,8 +37,8 @@ export class Batches extends APIResource {
   list(
     query: BatchListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<BatchListResponse> {
-    return this._client.get('/v1/messages/batches', { query, ...options });
+  ): PagePromise<BatchJobsArrayPage, BatchJob> {
+    return this._client.getAPIList('/v1/messages/batches', ArrayPage<BatchJob>, { query, ...options });
   }
 
   /**
@@ -48,11 +49,13 @@ export class Batches extends APIResource {
   }
 }
 
+export type BatchJobsArrayPage = ArrayPage<BatchJob>;
+
 export interface BatchJob {
   /**
    * The human-friendly ID of the Job
    */
-  id?: string;
+  id: string;
 
   /**
    * The agent associated with this job/run.
@@ -137,8 +140,6 @@ export interface BatchJob {
   updated_at?: string | null;
 }
 
-export type BatchListResponse = Array<BatchJob>;
-
 export type BatchCancelResponse = unknown;
 
 export interface BatchCreateParams {
@@ -268,50 +269,18 @@ export namespace BatchCreateParams {
   }
 }
 
-export interface BatchListParams {
-  /**
-   * Job ID cursor for pagination. Returns jobs that come after this job ID in the
-   * specified sort order
-   */
-  after?: string | null;
-
-  /**
-   * Job ID cursor for pagination. Returns jobs that come before this job ID in the
-   * specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of jobs to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for jobs by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
-}
+export interface BatchListParams extends ArrayPageParams {}
 
 Batches.Messages = Messages;
 
 export declare namespace Batches {
   export {
     type BatchJob as BatchJob,
-    type BatchListResponse as BatchListResponse,
     type BatchCancelResponse as BatchCancelResponse,
+    type BatchJobsArrayPage as BatchJobsArrayPage,
     type BatchCreateParams as BatchCreateParams,
     type BatchListParams as BatchListParams,
   };
 
-  export {
-    Messages as Messages,
-    type MessageListResponse as MessageListResponse,
-    type MessageListParams as MessageListParams,
-  };
+  export { Messages as Messages, type MessageListParams as MessageListParams };
 }

package/src/resources/batches/index.ts

@@ -3,9 +3,9 @@
 export {
   Batches,
   type BatchJob,
-  type BatchListResponse,
   type BatchCancelResponse,
   type BatchCreateParams,
   type BatchListParams,
+  type BatchJobsArrayPage,
 } from './batches';
-export { Messages, type MessageListResponse, type MessageListParams } from './messages';
+export { Messages, type MessageListParams } from './messages';

package/src/resources/batches/messages.ts

@@ -2,7 +2,8 @@
 
 import { APIResource } from '../../core/resource';
 import * as MessagesAPI from '../agents/messages';
-import { APIPromise } from '../../core/api-promise';
+import { MessagesObjectPage } from '../agents/messages';
+import { ObjectPage, type ObjectPageParams, PagePromise } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
@@ -14,50 +15,24 @@ export class Messages extends APIResource {
     batchID: string,
     query: MessageListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<MessageListResponse> {
-    return this._client.get(path`/v1/messages/batches/${batchID}/messages`, { query, ...options });
+  ): PagePromise<MessagesObjectPage, MessagesAPI.Message> {
+    return this._client.getAPIList(
+      path`/v1/messages/batches/${batchID}/messages`,
+      ObjectPage<MessagesAPI.Message>,
+      { query, ...options },
+    );
   }
 }
 
-export interface MessageListResponse {
-  messages: Array<MessagesAPI.Message>;
-}
-
-export interface MessageListParams {
-  /**
-   * Message ID cursor for pagination. Returns messages that come after this message
-   * ID in the specified sort order
-   */
-  after?: string | null;
-
+export interface MessageListParams extends ObjectPageParams {
   /**
    * Filter messages by agent ID
    */
   agent_id?: string | null;
-
-  /**
-   * Message ID cursor for pagination. Returns messages that come before this message
-   * ID in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of messages to return
-   */
-  limit?: number | null;
-
-  /**
-   * Sort order for messages by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
 }
 
 export declare namespace Messages {
-  export { type MessageListResponse as MessageListResponse, type MessageListParams as MessageListParams };
+  export { type MessageListParams as MessageListParams };
 }
+
+export { type MessagesObjectPage };

package/src/resources/blocks/blocks.ts

@@ -42,13 +42,6 @@ export class Blocks extends APIResource {
     return this._client.delete(path`/v1/blocks/${blockID}`, options);
   }
 
-  /**
-   * Count all blocks created by a user.
-   */
-  count(options?: RequestOptions): APIPromise<BlockCountResponse> {
-    return this._client.get('/v1/blocks/count', options);
-  }
-
   /**
    * Modify Block
    */
@@ -230,8 +223,6 @@ export interface CreateBlock {
 
 export type BlockDeleteResponse = unknown;
 
-export type BlockCountResponse = number;
-
 export interface BlockCreateParams {
   /**
    * Label of the block.
@@ -457,7 +448,6 @@ export declare namespace Blocks {
     type BlockResponse as BlockResponse,
     type CreateBlock as CreateBlock,
     type BlockDeleteResponse as BlockDeleteResponse,
-    type BlockCountResponse as BlockCountResponse,
     type BlockResponsesArrayPage as BlockResponsesArrayPage,
     type BlockCreateParams as BlockCreateParams,
     type BlockListParams as BlockListParams,

package/src/resources/blocks/index.ts

@@ -6,7 +6,6 @@ export {
   type BlockResponse,
   type CreateBlock,
   type BlockDeleteResponse,
-  type BlockCountResponse,
   type BlockCreateParams,
   type BlockListParams,
   type BlockModifyParams,

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,21 @@ 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
+   * The unique identifier of the source associated with the document.
    */
-  id?: string;
+  source_id: string;
 
   /**
    * Number of chunks that have been embedded.
@@ -225,39 +140,98 @@ 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
+   * 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;
+
+  /**
+   * 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;
 
   /**
-   * Maximum number of files to return
+   * 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.
    */
-  limit?: number | null;
+  file_path?: string | null;
 
   /**
-   * Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest
-   * first
+   * The size of the file in bytes.
    */
-  order?: 'asc' | 'desc';
+  file_size?: number | null;
 
   /**
-   * Field to sort by
+   * The type of the file (MIME type).
    */
-  order_by?: 'created_at';
+  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 +262,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';
 
@@ -41,8 +43,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 });
   }
 
   /**
@@ -52,13 +54,6 @@ export class Folders extends APIResource {
     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);
-  }
-
   /**
    * Update the name or documentation of an existing data folder.
    */
@@ -67,6 +62,8 @@ export class Folders extends APIResource {
   }
 }
 
+export type FoldersArrayPage = ArrayPage<Folder>;
+
 /**
  * Representation of a folder, which is a collection of files and passages.
  *
@@ -77,6 +74,11 @@ export class Folders extends APIResource {
  * of the folder.
  */
 export interface Folder {
+  /**
+   * The human-friendly ID of the Source
+   */
+  id: string;
+
   /**
    * The embedding configuration used by the folder.
    */
@@ -87,11 +89,6 @@ export interface Folder {
    */
   name: string;
 
-  /**
-   * The human-friendly ID of the Source
-   */
-  id?: string;
-
   /**
    * The timestamp when the folder was created.
    */
@@ -128,12 +125,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.
@@ -171,39 +164,11 @@ export interface FolderCreateParams {
   metadata?: { [key: string]: unknown } | 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';
 }
 
 export interface FolderModifyParams {
@@ -239,9 +204,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 FolderListParams as FolderListParams,
     type FolderModifyParams as FolderModifyParams,
@@ -251,6 +215,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 FolderListParams,
   type FolderModifyParams,
+  type FoldersArrayPage,
 } from './folders';

package/src/resources/groups/groups.ts

@@ -51,13 +51,6 @@ export class Groups extends APIResource {
     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);
-  }
-
   /**
    * Create a new multi-agent group with the specified configuration.
    */
@@ -195,8 +188,6 @@ export interface VoiceSleeptimeManager {
 
 export type GroupDeleteResponse = unknown;
 
-export type GroupCountResponse = number;
-
 export interface GroupCreateParams {
   agent_ids: Array<string>;
 
@@ -324,7 +315,6 @@ export declare namespace Groups {
     type SupervisorManager as SupervisorManager,
     type VoiceSleeptimeManager as VoiceSleeptimeManager,
     type GroupDeleteResponse as GroupDeleteResponse,
-    type GroupCountResponse as GroupCountResponse,
     type GroupsArrayPage as GroupsArrayPage,
     type GroupCreateParams as GroupCreateParams,
     type GroupListParams as GroupListParams,

package/src/resources/groups/index.ts

@@ -10,7 +10,6 @@ export {
   type SupervisorManager,
   type VoiceSleeptimeManager,
   type GroupDeleteResponse,
-  type GroupCountResponse,
   type GroupCreateParams,
   type GroupListParams,
   type GroupModifyParams,