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

package/src/resources/archives.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../core/resource';
 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';
 
@@ -28,8 +29,8 @@ export class Archives extends APIResource {
   list(
     query: ArchiveListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ArchiveListResponse> {
-    return this._client.get('/v1/archives/', { query, ...options });
+  ): PagePromise<ArchivesArrayPage, Archive> {
+    return this._client.getAPIList('/v1/archives/', ArrayPage<Archive>, { query, ...options });
   }
 
   /**
@@ -47,17 +48,18 @@ export class Archives extends APIResource {
   }
 }
 
+export type ArchivesArrayPage = ArrayPage<Archive>;
+
 /**
  * Representation of an archive - a collection of archival passages that can be
  * shared between agents.
- *
- * Parameters: id (str): The unique identifier of the archive. name (str): The name
- * of the archive. description (str): A description of the archive. organization_id
- * (str): The organization this archive belongs to. created_at (datetime): The
- * creation date of the archive. metadata (dict): Additional metadata for the
- * archive.
  */
 export interface Archive {
+  /**
+   * The human-friendly ID of the Archive
+   */
+  id: string;
+
   /**
    * The creation date of the archive
    */
@@ -73,11 +75,6 @@ export interface Archive {
    */
   name: string;
 
-  /**
-   * The human-friendly ID of the Archive
-   */
-  id?: string;
-
   /**
    * The id of the user that made this object.
    */
@@ -114,8 +111,6 @@ export interface Archive {
  */
 export type VectorDBProvider = 'native' | 'tpuf' | 'pinecone';
 
-export type ArchiveListResponse = Array<Archive>;
-
 export interface ArchiveCreateParams {
   /**
    * Embedding configuration for the archive
@@ -127,44 +122,16 @@ export interface ArchiveCreateParams {
   description?: string | null;
 }
 
-export interface ArchiveListParams {
-  /**
-   * Archive ID cursor for pagination. Returns archives that come after this archive
-   * ID in the specified sort order
-   */
-  after?: string | null;
-
+export interface ArchiveListParams extends ArrayPageParams {
   /**
    * Only archives attached to this agent ID
    */
   agent_id?: string | null;
 
-  /**
-   * Archive ID cursor for pagination. Returns archives that come before this archive
-   * ID in the specified sort order
-   */
-  before?: string | null;
-
-  /**
-   * Maximum number of archives to return
-   */
-  limit?: number | null;
-
   /**
    * Filter by archive name (exact match)
    */
   name?: string | null;
-
-  /**
-   * Sort order for archives by creation time. 'asc' for oldest first, 'desc' for
-   * newest first
-   */
-  order?: 'asc' | 'desc';
-
-  /**
-   * Field to sort by
-   */
-  order_by?: 'created_at';
 }
 
 export interface ArchiveModifyParams {
@@ -177,7 +144,7 @@ export declare namespace Archives {
   export {
     type Archive as Archive,
     type VectorDBProvider as VectorDBProvider,
-    type ArchiveListResponse as ArchiveListResponse,
+    type ArchivesArrayPage as ArchivesArrayPage,
     type ArchiveCreateParams as ArchiveCreateParams,
     type ArchiveListParams as ArchiveListParams,
     type ArchiveModifyParams as ArchiveModifyParams,

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,