@llamaindex/llama-cloud 2.9.0 → 2.9.1

package/src/resources/beta/indexes.ts

@@ -9,39 +9,19 @@ import { path } from '../../internal/utils/path';
 
 export class Indexes extends APIResource {
   /**
-   * Create a searchable index over a source directory.
-   *
-   * @example
-   * ```ts
-   * const index = await client.beta.indexes.create({
-   *   source_directory_id: 'dir-abc123',
-   * });
-   * ```
-   */
-  create(params: IndexCreateParams, options?: RequestOptions): APIPromise<IndexCreateResponse> {
-    const { organization_id, project_id, ...body } = params;
-    return this._client.post('/api/v1/indexes', { query: { organization_id, project_id }, body, ...options });
-  }
-
-  /**
-   * List indexes for the current project.
+   * Get an index by ID.
    *
    * @example
    * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const indexListResponse of client.beta.indexes.list()) {
-   *   // ...
-   * }
+   * const index = await client.beta.indexes.get('index_id');
    * ```
    */
-  list(
-    query: IndexListParams | null | undefined = {},
+  get(
+    indexID: string,
+    query: IndexGetParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<IndexListResponsesPaginatedCursor, IndexListResponse> {
-    return this._client.getAPIList('/api/v1/indexes', PaginatedCursor<IndexListResponse>, {
-      query,
-      ...options,
-    });
+  ): APIPromise<IndexGetResponse> {
+    return this._client.get(path`/api/v1/indexes/${indexID}`, { query, ...options });
   }
 
   /**
@@ -66,19 +46,18 @@ export class Indexes extends APIResource {
   }
 
   /**
-   * Get an index by ID.
+   * Create a searchable index over a source directory.
    *
    * @example
    * ```ts
-   * const index = await client.beta.indexes.get('index_id');
+   * const index = await client.beta.indexes.create({
+   *   source_directory_id: 'dir-abc123',
+   * });
    * ```
    */
-  get(
-    indexID: string,
-    query: IndexGetParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<IndexGetResponse> {
-    return this._client.get(path`/api/v1/indexes/${indexID}`, { query, ...options });
+  create(params: IndexCreateParams, options?: RequestOptions): APIPromise<IndexCreateResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post('/api/v1/indexes', { query: { organization_id, project_id }, body, ...options });
   }
 
   /**
@@ -101,6 +80,27 @@ export class Indexes extends APIResource {
       ...options,
     });
   }
+
+  /**
+   * List indexes for the current project.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const indexListResponse of client.beta.indexes.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: IndexListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<IndexListResponsesPaginatedCursor, IndexListResponse> {
+    return this._client.getAPIList('/api/v1/indexes', PaginatedCursor<IndexListResponse>, {
+      query,
+      ...options,
+    });
+  }
 }
 
 export type IndexListResponsesPaginatedCursor = PaginatedCursor<IndexListResponse>;
@@ -302,6 +302,18 @@ export interface IndexGetResponse {
 
 export type IndexSyncResponse = unknown;
 
+export interface IndexGetParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface IndexDeleteParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
 export interface IndexCreateParams {
   /**
    * Body param: ID of the source directory containing your documents.
@@ -379,30 +391,18 @@ export namespace IndexCreateParams {
   }
 }
 
-export interface IndexListParams extends PaginatedCursorParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
-
-  source_directory_id?: string | null;
-}
-
-export interface IndexDeleteParams {
+export interface IndexSyncParams {
   organization_id?: string | null;
 
   project_id?: string | null;
 }
 
-export interface IndexGetParams {
+export interface IndexListParams extends PaginatedCursorParams {
   organization_id?: string | null;
 
   project_id?: string | null;
-}
 
-export interface IndexSyncParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
+  source_directory_id?: string | null;
 }
 
 export declare namespace Indexes {
@@ -412,10 +412,10 @@ export declare namespace Indexes {
     type IndexGetResponse as IndexGetResponse,
     type IndexSyncResponse as IndexSyncResponse,
     type IndexListResponsesPaginatedCursor as IndexListResponsesPaginatedCursor,
-    type IndexCreateParams as IndexCreateParams,
-    type IndexListParams as IndexListParams,
-    type IndexDeleteParams as IndexDeleteParams,
     type IndexGetParams as IndexGetParams,
+    type IndexDeleteParams as IndexDeleteParams,
+    type IndexCreateParams as IndexCreateParams,
     type IndexSyncParams as IndexSyncParams,
+    type IndexListParams as IndexListParams,
   };
 }

package/src/resources/beta/retrieval.ts

@@ -333,13 +333,13 @@ export interface RetrievalRetrieveParams {
 
 export namespace RetrievalRetrieveParams {
   export interface FilterTypeUnionStrIntBoolFloat {
-    operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'in' | 'nin';
+    operator: 'eq' | 'gt' | 'gte' | 'in' | 'lt' | 'lte' | 'ne' | 'nin';
 
     value: string | boolean | number | Array<string | boolean | number>;
   }
 
   export interface UnionMember1 {
-    operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'in' | 'nin';
+    operator: 'eq' | 'gt' | 'gte' | 'in' | 'lt' | 'lte' | 'ne' | 'nin';
 
     value: number | Array<number>;
   }
@@ -368,7 +368,7 @@ export namespace RetrievalRetrieveParams {
 
   export namespace StaticFilters {
     export interface ParsedDirectoryFileID {
-      operator: 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'in' | 'nin';
+      operator: 'eq' | 'gt' | 'gte' | 'in' | 'lt' | 'lte' | 'ne' | 'nin';
 
       value: string | Array<string>;
     }

package/src/resources/beta/sheets.ts

@@ -17,14 +17,7 @@ export class Sheets extends APIResource {
    * default configuration is used. Optionally include `webhook_configurations` to
    * receive `sheets.*` status notifications.
    *
-   * Experimental: not production-ready and subject to change.
-   *
-   * @example
-   * ```ts
-   * const sheetsJob = await client.beta.sheets.create({
-   *   file_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   * });
-   * ```
+   * @deprecated
    */
   create(params: SheetCreateParams, options?: RequestOptions): APIPromise<SheetsJob> {
     const { organization_id, project_id, ...body } = params;
@@ -36,16 +29,9 @@ export class Sheets extends APIResource {
   }
 
   /**
-   * List spreadsheet parsing jobs. Experimental: not production-ready and subject to
-   * change.
+   * List spreadsheet parsing jobs.
    *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const sheetsJob of client.beta.sheets.list()) {
-   *   // ...
-   * }
-   * ```
+   * @deprecated
    */
   list(
     query: SheetListParams | null | undefined = {},
@@ -57,40 +43,12 @@ export class Sheets extends APIResource {
     });
   }
 
-  /**
-   * Delete a spreadsheet parsing job and its associated data. Experimental: not
-   * production-ready and subject to change.
-   *
-   * @example
-   * ```ts
-   * const response = await client.beta.sheets.deleteJob(
-   *   'spreadsheet_job_id',
-   * );
-   * ```
-   */
-  deleteJob(
-    spreadsheetJobID: string,
-    params: SheetDeleteJobParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<unknown> {
-    const { organization_id, project_id } = params ?? {};
-    return this._client.delete(path`/api/v1/beta/sheets/jobs/${spreadsheetJobID}`, {
-      query: { organization_id, project_id },
-      ...options,
-    });
-  }
-
   /**
    * Get a spreadsheet parsing job. When `include_results=True` (default), embeds
    * extracted regions and results if complete, skipping the separate `/results`
-   * call. Experimental: not production-ready and subject to change.
+   * call.
    *
-   * @example
-   * ```ts
-   * const sheetsJob = await client.beta.sheets.get(
-   *   'spreadsheet_job_id',
-   * );
-   * ```
+   * @deprecated
    */
   get(
     spreadsheetJobID: string,
@@ -101,20 +59,12 @@ export class Sheets extends APIResource {
   }
 
   /**
-   * Generate a presigned URL to download a specific extracted region. Experimental:
-   * not production-ready and subject to change.
+   * Generate a presigned URL to download a specific extracted region.
    *
-   * @example
-   * ```ts
-   * const presignedURL =
-   *   await client.beta.sheets.getResultTable('table', {
-   *     spreadsheet_job_id: 'spreadsheet_job_id',
-   *     region_id: 'region_id',
-   *   });
-   * ```
+   * @deprecated
    */
   getResultTable(
-    regionType: 'table' | 'extra' | 'cell_metadata',
+    regionType: 'cell_metadata' | 'extra' | 'table',
     params: SheetGetResultTableParams,
     options?: RequestOptions,
   ): APIPromise<FilesAPI.PresignedURL> {
@@ -125,6 +75,23 @@ export class Sheets extends APIResource {
     );
   }
 
+  /**
+   * Delete a spreadsheet parsing job and its associated data.
+   *
+   * @deprecated
+   */
+  deleteJob(
+    spreadsheetJobID: string,
+    params: SheetDeleteJobParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<unknown> {
+    const { organization_id, project_id } = params ?? {};
+    return this._client.delete(path`/api/v1/beta/sheets/jobs/${spreadsheetJobID}`, {
+      query: { organization_id, project_id },
+      ...options,
+    });
+  }
+
   /**
    * Create a spreadsheet parsing job and wait for it to complete, returning the job with results.
    *
@@ -281,7 +248,7 @@ export interface SheetsJob {
   /**
    * The status of the parsing job
    */
-  status: 'PENDING' | 'SUCCESS' | 'ERROR' | 'PARTIAL_SUCCESS' | 'CANCELLED';
+  status: 'CANCELLED' | 'ERROR' | 'PARTIAL_SUCCESS' | 'PENDING' | 'SUCCESS';
 
   /**
    * When the job was last updated
@@ -361,28 +328,33 @@ export namespace SheetsJob {
        * events are delivered.
        */
       webhook_events?: Array<
-        | 'extract.pending'
-        | 'extract.success'
+        | 'classify.cancelled'
+        | 'classify.error'
+        | 'classify.partial_success'
+        | 'classify.pending'
+        | 'classify.running'
+        | 'classify.success'
+        | 'extract.cancelled'
         | 'extract.error'
         | 'extract.partial_success'
-        | 'extract.cancelled'
+        | 'extract.pending'
+        | 'extract.success'
+        | 'parse.cancelled'
+        | 'parse.error'
+        | 'parse.partial_success'
         | 'parse.pending'
         | 'parse.running'
         | 'parse.success'
-        | 'parse.error'
-        | 'parse.partial_success'
-        | 'parse.cancelled'
-        | 'classify.pending'
-        | 'classify.running'
-        | 'classify.success'
-        | 'classify.error'
-        | 'classify.partial_success'
-        | 'classify.cancelled'
-        | 'sheets.pending'
-        | 'sheets.success'
+        | 'sheets.cancelled'
         | 'sheets.error'
         | 'sheets.partial_success'
-        | 'sheets.cancelled'
+        | 'sheets.pending'
+        | 'sheets.success'
+        | 'split.cancelled'
+        | 'split.error'
+        | 'split.pending'
+        | 'split.processing'
+        | 'split.success'
         | 'unmapped_event'
       > | null;
 
@@ -561,28 +533,33 @@ export namespace SheetCreateParams {
      * events are delivered.
      */
     webhook_events?: Array<
-      | 'extract.pending'
-      | 'extract.success'
+      | 'classify.cancelled'
+      | 'classify.error'
+      | 'classify.partial_success'
+      | 'classify.pending'
+      | 'classify.running'
+      | 'classify.success'
+      | 'extract.cancelled'
       | 'extract.error'
       | 'extract.partial_success'
-      | 'extract.cancelled'
+      | 'extract.pending'
+      | 'extract.success'
+      | 'parse.cancelled'
+      | 'parse.error'
+      | 'parse.partial_success'
       | 'parse.pending'
       | 'parse.running'
       | 'parse.success'
-      | 'parse.error'
-      | 'parse.partial_success'
-      | 'parse.cancelled'
-      | 'classify.pending'
-      | 'classify.running'
-      | 'classify.success'
-      | 'classify.error'
-      | 'classify.partial_success'
-      | 'classify.cancelled'
-      | 'sheets.pending'
-      | 'sheets.success'
+      | 'sheets.cancelled'
       | 'sheets.error'
       | 'sheets.partial_success'
-      | 'sheets.cancelled'
+      | 'sheets.pending'
+      | 'sheets.success'
+      | 'split.cancelled'
+      | 'split.error'
+      | 'split.pending'
+      | 'split.processing'
+      | 'split.success'
       | 'unmapped_event'
     > | null;
 
@@ -633,13 +610,7 @@ export interface SheetListParams extends PaginatedCursorParams {
   /**
    * Filter by job status
    */
-  status?: 'PENDING' | 'SUCCESS' | 'ERROR' | 'PARTIAL_SUCCESS' | 'CANCELLED' | null;
-}
-
-export interface SheetDeleteJobParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
+  status?: 'CANCELLED' | 'ERROR' | 'PARTIAL_SUCCESS' | 'PENDING' | 'SUCCESS' | null;
 }
 
 export interface SheetGetParams {
@@ -693,6 +664,12 @@ export interface SheetWaitForCompletionParams extends PollingOptions {
   project_id?: string | null;
 }
 
+export interface SheetDeleteJobParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
 export declare namespace Sheets {
   export {
     type SheetsJob as SheetsJob,
@@ -701,9 +678,9 @@ export declare namespace Sheets {
     type SheetsJobsPaginatedCursor as SheetsJobsPaginatedCursor,
     type SheetCreateParams as SheetCreateParams,
     type SheetListParams as SheetListParams,
-    type SheetDeleteJobParams as SheetDeleteJobParams,
     type SheetGetParams as SheetGetParams,
     type SheetGetResultTableParams as SheetGetResultTableParams,
+    type SheetDeleteJobParams as SheetDeleteJobParams,
     type SheetParseParams as SheetParseParams,
     type SheetWaitForCompletionParams as SheetWaitForCompletionParams,
   };

package/src/resources/beta/split.ts

@@ -506,7 +506,7 @@ export namespace SplitCreateParams {
        * be assigned to a defined category. 'omit': pages can be classified as
        * 'uncategorized' but are excluded from results.
        */
-      allow_uncategorized?: 'include' | 'forbid' | 'omit';
+      allow_uncategorized?: 'forbid' | 'include' | 'omit';
     }
   }
 }
@@ -534,7 +534,7 @@ export interface SplitListParams extends PaginatedCursorParams {
   /**
    * Filter by job status (pending, processing, completed, failed, cancelled)
    */
-  status?: 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled' | null;
+  status?: 'cancelled' | 'completed' | 'failed' | 'pending' | 'processing' | null;
 }
 
 export interface SplitGetParams {

package/src/resources/classifier/jobs.ts

@@ -389,7 +389,7 @@ export namespace JobCreateParams {
      * Format of the webhook payload body. 'string' (default) sends the payload as a
      * JSON-encoded string; 'json' sends it as a JSON object.
      */
-    webhook_output_format?: 'string' | 'json' | null;
+    webhook_output_format?: 'json' | 'string' | null;
 
     /**
      * HTTPS URL to receive webhook POST requests. Must be publicly accessible

package/src/resources/classify.ts

@@ -281,7 +281,8 @@ export interface ClassifyCreateRequest {
   parse_job_id?: string | null;
 
   /**
-   * Idempotency key scoped to the project
+   * Idempotency key scoped to the project. Reusing a key returns the original job;
+   * the new request body is ignored.
    */
   transaction_id?: string | null;
 
@@ -301,28 +302,33 @@ export namespace ClassifyCreateRequest {
      * events are delivered.
      */
     webhook_events?: Array<
-      | 'extract.pending'
-      | 'extract.success'
+      | 'classify.cancelled'
+      | 'classify.error'
+      | 'classify.partial_success'
+      | 'classify.pending'
+      | 'classify.running'
+      | 'classify.success'
+      | 'extract.cancelled'
       | 'extract.error'
       | 'extract.partial_success'
-      | 'extract.cancelled'
+      | 'extract.pending'
+      | 'extract.success'
+      | 'parse.cancelled'
+      | 'parse.error'
+      | 'parse.partial_success'
       | 'parse.pending'
       | 'parse.running'
       | 'parse.success'
-      | 'parse.error'
-      | 'parse.partial_success'
-      | 'parse.cancelled'
-      | 'classify.pending'
-      | 'classify.running'
-      | 'classify.success'
-      | 'classify.error'
-      | 'classify.partial_success'
-      | 'classify.cancelled'
-      | 'sheets.pending'
-      | 'sheets.success'
+      | 'sheets.cancelled'
       | 'sheets.error'
       | 'sheets.partial_success'
-      | 'sheets.cancelled'
+      | 'sheets.pending'
+      | 'sheets.success'
+      | 'split.cancelled'
+      | 'split.error'
+      | 'split.pending'
+      | 'split.processing'
+      | 'split.success'
       | 'unmapped_event'
     > | null;
 
@@ -380,7 +386,7 @@ export interface ClassifyCreateResponse {
   /**
    * Whether the input was a file or parse job (FILE or PARSE_JOB)
    */
-  document_input_type: 'url' | 'file_id' | 'parse_job_id';
+  document_input_type: 'file_id' | 'parse_job_id' | 'url';
 
   /**
    * ID of the input file or parse job
@@ -395,7 +401,7 @@ export interface ClassifyCreateResponse {
   /**
    * Current job status: PENDING, RUNNING, COMPLETED, or FAILED
    */
-  status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED';
+  status: 'COMPLETED' | 'FAILED' | 'PENDING' | 'RUNNING';
 
   /**
    * User who created this job
@@ -455,7 +461,7 @@ export interface ClassifyListResponse {
   /**
    * Whether the input was a file or parse job (FILE or PARSE_JOB)
    */
-  document_input_type: 'url' | 'file_id' | 'parse_job_id';
+  document_input_type: 'file_id' | 'parse_job_id' | 'url';
 
   /**
    * ID of the input file or parse job
@@ -470,7 +476,7 @@ export interface ClassifyListResponse {
   /**
    * Current job status: PENDING, RUNNING, COMPLETED, or FAILED
    */
-  status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED';
+  status: 'COMPLETED' | 'FAILED' | 'PENDING' | 'RUNNING';
 
   /**
    * User who created this job
@@ -530,7 +536,7 @@ export interface ClassifyGetResponse {
   /**
    * Whether the input was a file or parse job (FILE or PARSE_JOB)
    */
-  document_input_type: 'url' | 'file_id' | 'parse_job_id';
+  document_input_type: 'file_id' | 'parse_job_id' | 'url';
 
   /**
    * ID of the input file or parse job
@@ -545,7 +551,7 @@ export interface ClassifyGetResponse {
   /**
    * Current job status: PENDING, RUNNING, COMPLETED, or FAILED
    */
-  status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED';
+  status: 'COMPLETED' | 'FAILED' | 'PENDING' | 'RUNNING';
 
   /**
    * User who created this job
@@ -625,7 +631,8 @@ export interface ClassifyCreateParams {
   parse_job_id?: string | null;
 
   /**
-   * Body param: Idempotency key scoped to the project
+   * Body param: Idempotency key scoped to the project. Reusing a key returns the
+   * original job; the new request body is ignored.
    */
   transaction_id?: string | null;
 
@@ -645,28 +652,33 @@ export namespace ClassifyCreateParams {
      * events are delivered.
      */
     webhook_events?: Array<
-      | 'extract.pending'
-      | 'extract.success'
+      | 'classify.cancelled'
+      | 'classify.error'
+      | 'classify.partial_success'
+      | 'classify.pending'
+      | 'classify.running'
+      | 'classify.success'
+      | 'extract.cancelled'
       | 'extract.error'
       | 'extract.partial_success'
-      | 'extract.cancelled'
+      | 'extract.pending'
+      | 'extract.success'
+      | 'parse.cancelled'
+      | 'parse.error'
+      | 'parse.partial_success'
       | 'parse.pending'
       | 'parse.running'
       | 'parse.success'
-      | 'parse.error'
-      | 'parse.partial_success'
-      | 'parse.cancelled'
-      | 'classify.pending'
-      | 'classify.running'
-      | 'classify.success'
-      | 'classify.error'
-      | 'classify.partial_success'
-      | 'classify.cancelled'
-      | 'sheets.pending'
-      | 'sheets.success'
+      | 'sheets.cancelled'
       | 'sheets.error'
       | 'sheets.partial_success'
-      | 'sheets.cancelled'
+      | 'sheets.pending'
+      | 'sheets.success'
+      | 'split.cancelled'
+      | 'split.error'
+      | 'split.pending'
+      | 'split.processing'
+      | 'split.success'
       | 'unmapped_event'
     > | null;
 
@@ -715,7 +727,7 @@ export interface ClassifyListParams extends PaginatedCursorParams {
   /**
    * Filter by job status
    */
-  status?: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | null;
+  status?: 'COMPLETED' | 'FAILED' | 'PENDING' | 'RUNNING' | null;
 }
 
 export interface ClassifyGetParams {