@llamaindex/llama-cloud 2.9.0 → 2.10.0

package/src/resources/data-sources.ts

@@ -8,6 +8,17 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 export class DataSources extends APIResource {
+  /**
+   * List data sources for a given project. If project_id is not provided, uses the
+   * default project.
+   */
+  list(
+    query: DataSourceListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DataSourceListResponse> {
+    return this._client.get('/api/v1/data-sources', { query, ...options });
+  }
+
   /**
    * Create a new data source.
    */
@@ -20,6 +31,13 @@ export class DataSources extends APIResource {
     });
   }
 
+  /**
+   * Get a data source by ID.
+   */
+  get(dataSourceID: string, options?: RequestOptions): APIPromise<DataSource> {
+    return this._client.get(path`/api/v1/data-sources/${dataSourceID}`, options);
+  }
+
   /**
    * Update a data source by ID.
    */
@@ -31,17 +49,6 @@ export class DataSources extends APIResource {
     return this._client.put(path`/api/v1/data-sources/${dataSourceID}`, { body, ...options });
   }
 
-  /**
-   * List data sources for a given project. If project_id is not provided, uses the
-   * default project.
-   */
-  list(
-    query: DataSourceListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<DataSourceListResponse> {
-    return this._client.get('/api/v1/data-sources', { query, ...options });
-  }
-
   /**
    * Delete a data source by ID.
    */
@@ -51,13 +58,6 @@ export class DataSources extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
-
-  /**
-   * Get a data source by ID.
-   */
-  get(dataSourceID: string, options?: RequestOptions): APIPromise<DataSource> {
-    return this._client.get(path`/api/v1/data-sources/${dataSourceID}`, options);
-  }
 }
 
 /**
@@ -94,17 +94,17 @@ export interface DataSource {
   project_id: string;
 
   source_type:
-    | 'S3'
     | 'AZURE_STORAGE_BLOB'
+    | 'BOX'
+    | 'CONFLUENCE'
     | 'GOOGLE_DRIVE'
+    | 'JIRA'
+    | 'JIRA_V2'
     | 'MICROSOFT_ONEDRIVE'
     | 'MICROSOFT_SHAREPOINT'
-    | 'SLACK'
     | 'NOTION_PAGE'
-    | 'CONFLUENCE'
-    | 'JIRA'
-    | 'JIRA_V2'
-    | 'BOX';
+    | 'S3'
+    | 'SLACK';
 
   /**
    * Creation datetime
@@ -138,6 +138,12 @@ export interface DataSourceReaderVersionMetadata {
 
 export type DataSourceListResponse = Array<DataSource>;
 
+export interface DataSourceListParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
 export interface DataSourceCreateParams {
   /**
    * Body param: Component that implements the data source
@@ -165,17 +171,17 @@ export interface DataSourceCreateParams {
    * Body param
    */
   source_type:
-    | 'S3'
     | 'AZURE_STORAGE_BLOB'
+    | 'BOX'
+    | 'CONFLUENCE'
     | 'GOOGLE_DRIVE'
+    | 'JIRA'
+    | 'JIRA_V2'
     | 'MICROSOFT_ONEDRIVE'
     | 'MICROSOFT_SHAREPOINT'
-    | 'SLACK'
     | 'NOTION_PAGE'
-    | 'CONFLUENCE'
-    | 'JIRA'
-    | 'JIRA_V2'
-    | 'BOX';
+    | 'S3'
+    | 'SLACK';
 
   /**
    * Query param
@@ -198,17 +204,17 @@ export interface DataSourceCreateParams {
 
 export interface DataSourceUpdateParams {
   source_type:
-    | 'S3'
     | 'AZURE_STORAGE_BLOB'
+    | 'BOX'
+    | 'CONFLUENCE'
     | 'GOOGLE_DRIVE'
+    | 'JIRA'
+    | 'JIRA_V2'
     | 'MICROSOFT_ONEDRIVE'
     | 'MICROSOFT_SHAREPOINT'
-    | 'SLACK'
     | 'NOTION_PAGE'
-    | 'CONFLUENCE'
-    | 'JIRA'
-    | 'JIRA_V2'
-    | 'BOX';
+    | 'S3'
+    | 'SLACK';
 
   /**
    * Component that implements the data source
@@ -241,19 +247,13 @@ export interface DataSourceUpdateParams {
   name?: string | null;
 }
 
-export interface DataSourceListParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
-}
-
 export declare namespace DataSources {
   export {
     type DataSource as DataSource,
     type DataSourceReaderVersionMetadata as DataSourceReaderVersionMetadata,
     type DataSourceListResponse as DataSourceListResponse,
+    type DataSourceListParams as DataSourceListParams,
     type DataSourceCreateParams as DataSourceCreateParams,
     type DataSourceUpdateParams as DataSourceUpdateParams,
-    type DataSourceListParams as DataSourceListParams,
   };
 }

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.
    *
@@ -326,11 +326,13 @@ 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.
+   * (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,28 +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.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;
 
@@ -525,6 +532,14 @@ export namespace ExtractV2JobCreate {
      */
     webhook_output_format?: string | null;
 
+    /**
+     * Shared signing secret used to sign webhook deliveries. When set, each request
+     * includes an HMAC-SHA256 signature of the request body in the 'LC-Signature'
+     * header (value 'sha256=<hex>'). Recompute the HMAC over the raw request body with
+     * this secret to verify the delivery is authentic.
+     */
+    webhook_signing_secret?: string | null;
+
     /**
      * URL to receive webhook POST notifications
      */
@@ -680,28 +695,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.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,6 +735,14 @@ export namespace ExtractCreateParams {
      */
     webhook_output_format?: string | null;
 
+    /**
+     * Shared signing secret used to sign webhook deliveries. When set, each request
+     * includes an HMAC-SHA256 signature of the request body in the 'LC-Signature'
+     * header (value 'sha256=<hex>'). Recompute the HMAC over the raw request body with
+     * this secret to verify the delivery is authentic.
+     */
+    webhook_signing_secret?: string | null;
+
     /**
      * URL to receive webhook POST notifications
      */
@@ -770,7 +798,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 {
@@ -779,6 +818,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
@@ -813,26 +861,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,
@@ -849,9 +877,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,
   };
 }