@llamaindex/llama-cloud 2.8.0 → 2.9.1

package/src/resources/extract.ts

@@ -66,66 +66,45 @@ export class Extract extends APIResource {
   }
 
   /**
-   * Delete an extraction job and its results.
+   * Get a single extraction job by ID.
+   *
+   * Returns the job status and results when complete. Use `expand=configuration` to
+   * include the full configuration used, and `expand=extract_metadata` for per-field
+   * metadata.
    *
    * @example
    * ```ts
-   * const extract = await client.extract.delete('job_id');
+   * const extractV2Job = await client.extract.get('job_id');
    * ```
    */
-  delete(
+  get(
     jobID: string,
-    params: ExtractDeleteParams | null | undefined = {},
+    query: ExtractGetParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<unknown> {
-    const { organization_id, project_id } = params ?? {};
-    return this._client.delete(path`/api/v2/extract/${jobID}`, {
-      query: { organization_id, project_id },
-      ...options,
-    });
+  ): APIPromise<ExtractV2Job> {
+    return this._client.get(path`/api/v2/extract/${jobID}`, { query, ...options });
   }
 
   /**
-   * Generate a JSON schema and return a product configuration request.
+   * Delete an extraction job and its results.
    *
    * @example
    * ```ts
-   * const configurationCreate =
-   *   await client.extract.generateSchema();
+   * const extract = await client.extract.delete('job_id');
    * ```
    */
-  generateSchema(
-    params: ExtractGenerateSchemaParams,
+  delete(
+    jobID: string,
+    params: ExtractDeleteParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<ConfigurationsAPI.ConfigurationCreate> {
-    const { organization_id, project_id, ...body } = params;
-    return this._client.post('/api/v2/extract/schema/generate', {
+  ): APIPromise<unknown> {
+    const { organization_id, project_id } = params ?? {};
+    return this._client.delete(path`/api/v2/extract/${jobID}`, {
       query: { organization_id, project_id },
-      body,
       ...options,
     });
   }
 
-  /**
-   * Get a single extraction job by ID.
-   *
-   * Returns the job status and results when complete. Use `expand=configuration` to
-   * include the full configuration used, and `expand=extract_metadata` for per-field
-   * metadata.
-   *
-   * @example
-   * ```ts
-   * const extractV2Job = await client.extract.get('job_id');
-   * ```
-   */
-  get(
-    jobID: string,
-    query: ExtractGetParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<ExtractV2Job> {
-    return this._client.get(path`/api/v2/extract/${jobID}`, { query, ...options });
-  }
-
   /**
    * Validate a JSON schema for extraction.
    *
@@ -135,15 +114,15 @@ export class Extract extends APIResource {
    *   await client.extract.validateSchema({
    *     data_schema: {
    *       properties: {
-   *         vendor_name: 'bar',
    *         invoice_number: 'bar',
-   *         total_amount: 'bar',
    *         line_items: 'bar',
+   *         total_amount: 'bar',
+   *         vendor_name: 'bar',
    *       },
    *       required: [
-   *         'vendor_name',
    *         'invoice_number',
    *         'total_amount',
+   *         'vendor_name',
    *       ],
    *       type: 'object',
    *     },
@@ -157,6 +136,27 @@ export class Extract extends APIResource {
     return this._client.post('/api/v2/extract/schema/validation', { body, ...options });
   }
 
+  /**
+   * Generate a JSON schema and return a product configuration request.
+   *
+   * @example
+   * ```ts
+   * const configurationCreate =
+   *   await client.extract.generateSchema();
+   * ```
+   */
+  generateSchema(
+    params: ExtractGenerateSchemaParams,
+    options?: RequestOptions,
+  ): APIPromise<ConfigurationsAPI.ConfigurationCreate> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post('/api/v2/extract/schema/generate', {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+
   /**
    * Wait for an extraction job to complete by polling until it reaches a terminal state.
    *
@@ -289,12 +289,6 @@ export interface ExtractConfiguration {
    */
   confidence_scores?: boolean;
 
-  /**
-   * Extract algorithm version. Use 'latest' for the default pipeline or a date
-   * string (e.g. '2026-01-08') to pin to a specific release.
-   */
-  extract_version?: string;
-
   /**
    * Granularity of extraction: per_doc returns one object per document, per_page
    * returns one object per page, per_table_row returns one object per table row
@@ -332,7 +326,15 @@ export interface ExtractConfiguration {
   /**
    * Extract tier: cost_effective (5 credits/page) or agentic (15 credits/page)
    */
-  tier?: 'cost_effective' | 'agentic';
+  tier?: 'agentic' | 'cost_effective';
+
+  /**
+   * Use 'latest' for the latest release for the selected tier or a date string
+   * (YYYY-MM-DD format) to pin to the nearest release at or before that date. Job
+   * responses always report the concrete resolved version the job runs, fixed at job
+   * creation; saved configurations keep the value as provided.
+   */
+  version?: string;
 }
 
 /**
@@ -490,22 +492,33 @@ export namespace ExtractV2JobCreate {
      * 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.success'
-      | 'classify.error'
-      | 'classify.partial_success'
-      | 'classify.cancelled'
+      | 'sheets.cancelled'
+      | 'sheets.error'
+      | 'sheets.partial_success'
+      | 'sheets.pending'
+      | 'sheets.success'
+      | 'split.cancelled'
+      | 'split.error'
+      | 'split.pending'
+      | 'split.processing'
+      | 'split.success'
       | 'unmapped_event'
     > | null;
 
@@ -674,22 +687,33 @@ export namespace ExtractCreateParams {
      * 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.success'
-      | 'classify.error'
-      | 'classify.partial_success'
-      | 'classify.cancelled'
+      | 'sheets.cancelled'
+      | 'sheets.error'
+      | 'sheets.partial_success'
+      | 'sheets.pending'
+      | 'sheets.success'
+      | 'split.cancelled'
+      | 'split.error'
+      | 'split.pending'
+      | 'split.processing'
+      | 'split.success'
       | 'unmapped_event'
     > | null;
 
@@ -758,7 +782,18 @@ export interface ExtractListParams extends PaginatedCursorParams {
   /**
    * Filter by status
    */
-  status?: 'PENDING' | 'THROTTLED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | null;
+  status?: 'CANCELLED' | 'COMPLETED' | 'FAILED' | 'PENDING' | 'RUNNING' | 'THROTTLED' | null;
+}
+
+export interface ExtractGetParams {
+  /**
+   * Additional fields to include: configuration, extract_metadata
+   */
+  expand?: Array<string>;
+
+  organization_id?: string | null;
+
+  project_id?: string | null;
 }
 
 export interface ExtractDeleteParams {
@@ -767,6 +802,15 @@ export interface ExtractDeleteParams {
   project_id?: string | null;
 }
 
+export interface ExtractValidateSchemaParams {
+  /**
+   * JSON Schema to validate for use with extract jobs
+   */
+  data_schema: {
+    [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null;
+  };
+}
+
 export interface ExtractGenerateSchemaParams {
   /**
    * Query param
@@ -801,26 +845,6 @@ export interface ExtractGenerateSchemaParams {
   prompt?: string | null;
 }
 
-export interface ExtractGetParams {
-  /**
-   * Additional fields to include: configuration, extract_metadata
-   */
-  expand?: Array<string>;
-
-  organization_id?: string | null;
-
-  project_id?: string | null;
-}
-
-export interface ExtractValidateSchemaParams {
-  /**
-   * JSON Schema to validate for use with extract jobs
-   */
-  data_schema: {
-    [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null;
-  };
-}
-
 export declare namespace Extract {
   export {
     type ExtractConfiguration as ExtractConfiguration,
@@ -837,9 +861,9 @@ export declare namespace Extract {
     type ExtractV2JobsPaginatedCursor as ExtractV2JobsPaginatedCursor,
     type ExtractCreateParams as ExtractCreateParams,
     type ExtractListParams as ExtractListParams,
-    type ExtractDeleteParams as ExtractDeleteParams,
-    type ExtractGenerateSchemaParams as ExtractGenerateSchemaParams,
     type ExtractGetParams as ExtractGetParams,
+    type ExtractDeleteParams as ExtractDeleteParams,
     type ExtractValidateSchemaParams as ExtractValidateSchemaParams,
+    type ExtractGenerateSchemaParams as ExtractGenerateSchemaParams,
   };
 }

package/src/resources/files.ts

@@ -28,6 +28,20 @@ export class Files extends APIResource {
     );
   }
 
+  /**
+   * Query files with filtering and pagination. Deprecated: use `GET /files`.
+   *
+   * @deprecated Use the GET /files endpoint instead
+   */
+  query(params: FileQueryParams, options?: RequestOptions): APIPromise<FileQueryResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post('/api/v1/beta/files/query', {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+
   /**
    * List files with optional filtering and pagination.
    *
@@ -70,20 +84,6 @@ export class Files extends APIResource {
   ): APIPromise<PresignedURL> {
     return this._client.get(path`/api/v1/beta/files/${fileID}/content`, { query, ...options });
   }
-
-  /**
-   * Query files with filtering and pagination. Deprecated: use `GET /files`.
-   *
-   * @deprecated Use the GET /files endpoint instead
-   */
-  query(params: FileQueryParams, options?: RequestOptions): APIPromise<FileQueryResponse> {
-    const { organization_id, project_id, ...body } = params;
-    return this._client.post('/api/v1/beta/files/query', {
-      query: { organization_id, project_id },
-      body,
-      ...options,
-    });
-  }
 }
 
 export type FileListResponsesPaginatedCursor = PaginatedCursor<FileListResponse>;
@@ -395,52 +395,6 @@ export interface FileCreateParams {
   external_file_id?: string | null;
 }
 
-export interface FileListParams extends PaginatedCursorParams {
-  /**
-   * Fields to expand on each file.
-   */
-  expand?: Array<string> | null;
-
-  /**
-   * Filter by external file ID.
-   */
-  external_file_id?: string | null;
-
-  /**
-   * Filter by specific file IDs.
-   */
-  file_ids?: Array<string> | null;
-
-  /**
-   * Filter by file name (exact match).
-   */
-  file_name?: string | null;
-
-  /**
-   * A comma-separated list of fields to order by, sorted in ascending order. Use
-   * 'field_name desc' to specify descending order.
-   */
-  order_by?: string | null;
-
-  organization_id?: string | null;
-
-  project_id?: string | null;
-}
-
-export interface FileDeleteParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
-}
-
-export interface FileGetParams {
-  expires_at_seconds?: number | null;
-
-  organization_id?: string | null;
-
-  project_id?: string | null;
-}
-
 export interface FileQueryParams {
   /**
    * Query param
@@ -514,6 +468,52 @@ export namespace FileQueryParams {
   }
 }
 
+export interface FileListParams extends PaginatedCursorParams {
+  /**
+   * Fields to expand on each file.
+   */
+  expand?: Array<string> | null;
+
+  /**
+   * Filter by external file ID.
+   */
+  external_file_id?: string | null;
+
+  /**
+   * Filter by specific file IDs.
+   */
+  file_ids?: Array<string> | null;
+
+  /**
+   * Filter by file name (exact match).
+   */
+  file_name?: string | null;
+
+  /**
+   * A comma-separated list of fields to order by, sorted in ascending order. Use
+   * 'field_name desc' to specify descending order.
+   */
+  order_by?: string | null;
+
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface FileDeleteParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export interface FileGetParams {
+  expires_at_seconds?: number | null;
+
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
 export declare namespace Files {
   export {
     type File as File,
@@ -523,9 +523,9 @@ export declare namespace Files {
     type FileQueryResponse as FileQueryResponse,
     type FileListResponsesPaginatedCursor as FileListResponsesPaginatedCursor,
     type FileCreateParams as FileCreateParams,
+    type FileQueryParams as FileQueryParams,
     type FileListParams as FileListParams,
     type FileDeleteParams as FileDeleteParams,
     type FileGetParams as FileGetParams,
-    type FileQueryParams as FileQueryParams,
   };
 }

package/src/resources/index.ts

@@ -36,9 +36,9 @@ export {
   type SplitV1Parameters,
   type UntypedParameters,
   type ConfigurationCreateParams,
+  type ConfigurationListParams,
   type ConfigurationRetrieveParams,
   type ConfigurationUpdateParams,
-  type ConfigurationListParams,
   type ConfigurationDeleteParams,
   type ConfigurationResponsesPaginatedCursor,
 } from './configurations';
@@ -46,18 +46,18 @@ export {
   DataSinks,
   type DataSink,
   type DataSinkListResponse,
+  type DataSinkListParams,
   type DataSinkCreateParams,
   type DataSinkUpdateParams,
-  type DataSinkListParams,
 } from './data-sinks';
 export {
   DataSources,
   type DataSource,
   type DataSourceReaderVersionMetadata,
   type DataSourceListResponse,
+  type DataSourceListParams,
   type DataSourceCreateParams,
   type DataSourceUpdateParams,
-  type DataSourceListParams,
 } from './data-sources';
 export {
   Extract,
@@ -74,10 +74,10 @@ export {
   type ExtractDeleteResponse,
   type ExtractCreateParams,
   type ExtractListParams,
-  type ExtractDeleteParams,
-  type ExtractGenerateSchemaParams,
   type ExtractGetParams,
+  type ExtractDeleteParams,
   type ExtractValidateSchemaParams,
+  type ExtractGenerateSchemaParams,
   type ExtractV2JobsPaginatedCursor,
 } from './extract';
 export {
@@ -88,10 +88,10 @@ export {
   type FileListResponse,
   type FileQueryResponse,
   type FileCreateParams,
+  type FileQueryParams,
   type FileListParams,
   type FileDeleteParams,
   type FileGetParams,
-  type FileQueryParams,
   type FileListResponsesPaginatedCursor,
 } from './files';
 export {
@@ -116,8 +116,8 @@ export {
   type ParsingListResponse,
   type ParsingGetResponse,
   type ParsingCreateParams,
-  type ParsingListParams,
   type ParsingGetParams,
+  type ParsingListParams,
   type ParsingListResponsesPaginatedCursor,
 } from './parsing';
 export {
@@ -155,12 +155,12 @@ export {
   type VertexTextEmbedding,
   type PipelineRetrieveResponse,
   type PipelineListResponse,
+  type PipelineListParams,
   type PipelineCreateParams,
-  type PipelineRetrieveParams,
   type PipelineUpdateParams,
-  type PipelineListParams,
   type PipelineGetStatusParams,
   type PipelineUpsertParams,
+  type PipelineRetrieveParams,
 } from './pipelines/pipelines';
 export {
   Projects,
@@ -179,10 +179,19 @@ export {
   type RetrieverPipeline,
   type RetrieverListResponse,
   type RetrieverCreateParams,
-  type RetrieverUpdateParams,
+  type RetrieverUpsertParams,
   type RetrieverListParams,
-  type RetrieverDeleteParams,
   type RetrieverGetParams,
+  type RetrieverUpdateParams,
+  type RetrieverDeleteParams,
   type RetrieverSearchParams,
-  type RetrieverUpsertParams,
 } from './retrievers/retrievers';
+export {
+  Sheets,
+  type SheetDeleteJobResponse,
+  type SheetCreateParams,
+  type SheetListParams,
+  type SheetGetParams,
+  type SheetGetResultTableParams,
+  type SheetDeleteJobParams,
+} from './sheets';