@llamaindex/llama-cloud 2.9.0 → 2.10.0

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;
 
@@ -336,6 +342,14 @@ export namespace ClassifyCreateRequest {
      */
     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
      */
@@ -380,7 +394,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 +409,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 +469,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 +484,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 +544,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 +559,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 +639,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 +660,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;
 
@@ -680,6 +700,14 @@ export namespace ClassifyCreateParams {
      */
     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
      */
@@ -715,7 +743,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 {

package/src/resources/configurations.ts

@@ -23,6 +23,19 @@ export class Configurations extends APIResource {
     });
   }
 
+  /**
+   * List product configurations for the current project.
+   */
+  list(
+    query: ConfigurationListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ConfigurationResponsesPaginatedCursor, ConfigurationResponse> {
+    return this._client.getAPIList('/api/v1/beta/configurations', PaginatedCursor<ConfigurationResponse>, {
+      query,
+      ...options,
+    });
+  }
+
   /**
    * Get a single product configuration by ID.
    */
@@ -50,19 +63,6 @@ export class Configurations extends APIResource {
     });
   }
 
-  /**
-   * List product configurations for the current project.
-   */
-  list(
-    query: ConfigurationListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<ConfigurationResponsesPaginatedCursor, ConfigurationResponse> {
-    return this._client.getAPIList('/api/v1/beta/configurations', PaginatedCursor<ConfigurationResponse>, {
-      query,
-      ...options,
-    });
-  }
-
   /**
    * Delete a product configuration.
    */
@@ -158,10 +158,10 @@ export interface ConfigurationCreate {
    * Product-specific configuration parameters.
    */
   parameters:
-    | SplitV1Parameters
-    | ExtractV2Parameters
     | ClassifyV2Parameters
+    | ExtractV2Parameters
     | ParseV2Parameters
+    | SplitV1Parameters
     | ConfigurationCreate.SpreadsheetV1Parameters
     | UntypedParameters;
 }
@@ -244,17 +244,17 @@ export interface ConfigurationResponse {
    * Product-specific configuration parameters.
    */
   parameters:
-    | SplitV1Parameters
-    | ExtractV2Parameters
     | ClassifyV2Parameters
+    | ExtractV2Parameters
     | ParseV2Parameters
+    | SplitV1Parameters
     | ConfigurationResponse.SpreadsheetV1Parameters
     | UntypedParameters;
 
   /**
    * Product type.
    */
-  product_type: 'split_v1' | 'extract_v2' | 'classify_v2' | 'parse_v2' | 'spreadsheet_v1' | 'unknown';
+  product_type: 'classify_v2' | 'extract_v2' | 'parse_v2' | 'split_v1' | 'spreadsheet_v1' | 'unknown';
 
   /**
    * Version identifier (datetime string).
@@ -396,11 +396,13 @@ export interface ExtractV2Parameters {
   /**
    * 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;
 }
@@ -423,7 +425,7 @@ export interface ParseV2Parameters {
    * 'agentic' (AI-powered with custom prompts), or 'agentic_plus' (premium AI with
    * highest accuracy)
    */
-  tier: 'fast' | 'cost_effective' | 'agentic' | 'agentic_plus';
+  tier: 'agentic' | 'agentic_plus' | 'cost_effective' | 'fast';
 
   /**
    * Version for the selected tier. Use `latest`, or pin one of that tier's dated
@@ -432,13 +434,13 @@ export interface ParseV2Parameters {
    * Current `latest` by tier:
    *
    * - `fast`: `2025-12-11`
-   * - `cost_effective`: `2026-06-05`
-   * - `agentic`: `2026-06-04`
-   * - `agentic_plus`: `2026-06-04`
+   * - `cost_effective`: `2026-06-26`
+   * - `agentic`: `2026-06-18`
+   * - `agentic_plus`: `2026-06-18`
    *
    * Full list: `GET /api/v2/parse/versions`.
    */
-  version: 'latest' | '2026-06-05' | '2026-06-04' | '2025-12-11' | (string & {});
+  version: 'latest' | '2026-06-26' | '2026-06-18' | '2025-12-11' | (string & {});
 
   /**
    * Options for AI-powered parsing tiers (cost_effective, agentic, agentic_plus).
@@ -502,6 +504,11 @@ export interface ParseV2Parameters {
    */
   processing_options?: ParseV2Parameters.ProcessingOptions;
 
+  /**
+   * IDs of saved webhook configurations to notify for this job.
+   */
+  webhook_configuration_ids?: Array<string> | null;
+
   /**
    * Webhook endpoints for job status notifications. Multiple webhooks can be
    * configured for different events or services
@@ -565,6 +572,11 @@ export namespace ParseV2Parameters {
      */
     html?: InputOptions.HTML;
 
+    /**
+     * Image parsing options (applies to .jpg, .jpeg, .png, .webp files)
+     */
+    image?: InputOptions.Image;
+
     /**
      * PDF-specific parsing options (applies to .pdf files)
      */
@@ -604,6 +616,20 @@ export namespace ParseV2Parameters {
       remove_navigation_elements?: boolean | null;
     }
 
+    /**
+     * Image parsing options (applies to .jpg, .jpeg, .png, .webp files)
+     */
+    export interface Image {
+      /**
+       * Detect documents photographed with a camera (e.g. phone scans of receipts or
+       * forms), then crop, perspective-correct, and flatten uneven lighting and shadows
+       * before parsing. Supports JPEG, PNG, WebP, and HEIC/HEIF inputs. Improves results
+       * when the document is tilted or surrounded by background. Images that already
+       * look like clean scans are left untouched
+       */
+      camera_photo_correction?: boolean | null;
+    }
+
     /**
      * Presentation parsing options (applies to .pptx, .ppt, .odp, .key files)
      */
@@ -692,7 +718,7 @@ export namespace ParseV2Parameters {
      * (cropped regions from layout detection like figures and diagrams). Empty list
      * saves no images
      */
-    images_to_save?: Array<'screenshot' | 'embedded' | 'layout'>;
+    images_to_save?: Array<'embedded' | 'layout' | 'screenshot'>;
 
     /**
      * Markdown formatting options including table styles and link annotations
@@ -942,7 +968,7 @@ export namespace ParseV2Parameters {
      * 'agentic' (balanced), 'agentic_plus' (highest accuracy). Automatically enables
      * extract_layout and precise_bounding_box when set
      */
-    specialized_chart_parsing?: 'agentic_plus' | 'agentic' | 'efficient' | null;
+    specialized_chart_parsing?: 'agentic' | 'agentic_plus' | 'efficient' | null;
   }
 
   export namespace ProcessingOptions {
@@ -1199,12 +1225,12 @@ export namespace ParseV2Parameters {
         /**
          * Enable specialized chart parsing with the specified mode
          */
-        specialized_chart_parsing?: 'agentic_plus' | 'agentic' | 'efficient' | null;
+        specialized_chart_parsing?: 'agentic' | 'agentic_plus' | 'efficient' | null;
 
         /**
          * Override the parsing tier for matched pages. Must be paired with version
          */
-        tier?: 'fast' | 'cost_effective' | 'agentic' | 'agentic_plus' | null;
+        tier?: 'agentic' | 'agentic_plus' | 'cost_effective' | 'fast' | null;
 
         /**
          * Version for the override tier. Required when `tier` is set. Use `latest`, or pin
@@ -1213,13 +1239,13 @@ export namespace ParseV2Parameters {
          * Current `latest` by tier:
          *
          * - `fast`: `2025-12-11`
-         * - `cost_effective`: `2026-06-05`
-         * - `agentic`: `2026-06-04`
-         * - `agentic_plus`: `2026-06-04`
+         * - `cost_effective`: `2026-06-26`
+         * - `agentic`: `2026-06-18`
+         * - `agentic_plus`: `2026-06-18`
          *
          * Full list: `GET /api/v2/parse/versions`.
          */
-        version?: 'latest' | '2026-06-05' | '2026-06-04' | '2025-12-11' | (string & {}) | null;
+        version?: 'latest' | '2026-06-26' | '2026-06-18' | '2025-12-11' | (string & {}) | null;
       }
 
       export namespace ParsingConf {
@@ -1377,7 +1403,15 @@ export namespace ParseV2Parameters {
      * 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;
+
+    /**
+     * 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;
 
     /**
      * HTTPS URL to receive webhook POST requests. Must be publicly accessible
@@ -1417,7 +1451,7 @@ export namespace SplitV1Parameters {
      * 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';
   }
 }
 
@@ -1445,10 +1479,10 @@ export interface ConfigurationCreateParams {
    * Body param: Product-specific configuration parameters.
    */
   parameters:
-    | SplitV1Parameters
-    | ExtractV2Parameters
     | ClassifyV2Parameters
+    | ExtractV2Parameters
     | ParseV2Parameters
+    | SplitV1Parameters
     | ConfigurationCreateParams.SpreadsheetV1Parameters
     | UntypedParameters;
 
@@ -1523,6 +1557,29 @@ export namespace ConfigurationCreateParams {
   }
 }
 
+export interface ConfigurationListParams extends PaginatedCursorParams {
+  /**
+   * Return only the latest version per configuration name.
+   */
+  latest_only?: boolean;
+
+  /**
+   * Filter by configuration name.
+   */
+  name?: string | null;
+
+  organization_id?: string | null;
+
+  /**
+   * Filter by one or more product types. Repeat the parameter for multiple values.
+   */
+  product_type?: Array<
+    'classify_v2' | 'extract_v2' | 'parse_v2' | 'split_v1' | 'spreadsheet_v1' | 'unknown'
+  > | null;
+
+  project_id?: string | null;
+}
+
 export interface ConfigurationRetrieveParams {
   organization_id?: string | null;
 
@@ -1549,10 +1606,10 @@ export interface ConfigurationUpdateParams {
    * Body param: Updated parameters (omit to leave unchanged).
    */
   parameters?:
-    | SplitV1Parameters
-    | ExtractV2Parameters
     | ClassifyV2Parameters
+    | ExtractV2Parameters
     | ParseV2Parameters
+    | SplitV1Parameters
     | ConfigurationUpdateParams.SpreadsheetV1Parameters
     | UntypedParameters
     | null;
@@ -1618,29 +1675,6 @@ export namespace ConfigurationUpdateParams {
   }
 }
 
-export interface ConfigurationListParams extends PaginatedCursorParams {
-  /**
-   * Return only the latest version per configuration name.
-   */
-  latest_only?: boolean;
-
-  /**
-   * Filter by configuration name.
-   */
-  name?: string | null;
-
-  organization_id?: string | null;
-
-  /**
-   * Filter by one or more product types. Repeat the parameter for multiple values.
-   */
-  product_type?: Array<
-    'split_v1' | 'extract_v2' | 'classify_v2' | 'parse_v2' | 'spreadsheet_v1' | 'unknown'
-  > | null;
-
-  project_id?: string | null;
-}
-
 export interface ConfigurationDeleteParams {
   organization_id?: string | null;
 
@@ -1658,9 +1692,9 @@ export declare namespace Configurations {
     type UntypedParameters as UntypedParameters,
     type ConfigurationResponsesPaginatedCursor as ConfigurationResponsesPaginatedCursor,
     type ConfigurationCreateParams as ConfigurationCreateParams,
+    type ConfigurationListParams as ConfigurationListParams,
     type ConfigurationRetrieveParams as ConfigurationRetrieveParams,
     type ConfigurationUpdateParams as ConfigurationUpdateParams,
-    type ConfigurationListParams as ConfigurationListParams,
     type ConfigurationDeleteParams as ConfigurationDeleteParams,
   };
 }

package/src/resources/data-sinks.ts

@@ -8,6 +8,16 @@ import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
 
 export class DataSinks extends APIResource {
+  /**
+   * List data sinks for a given project.
+   */
+  list(
+    query: DataSinkListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<DataSinkListResponse> {
+    return this._client.get('/api/v1/data-sinks', { query, ...options });
+  }
+
   /**
    * Create a new data sink.
    */
@@ -21,20 +31,17 @@ export class DataSinks extends APIResource {
   }
 
   /**
-   * Update a data sink by ID.
+   * Get a data sink by ID.
    */
-  update(dataSinkID: string, body: DataSinkUpdateParams, options?: RequestOptions): APIPromise<DataSink> {
-    return this._client.put(path`/api/v1/data-sinks/${dataSinkID}`, { body, ...options });
+  get(dataSinkID: string, options?: RequestOptions): APIPromise<DataSink> {
+    return this._client.get(path`/api/v1/data-sinks/${dataSinkID}`, options);
   }
 
   /**
-   * List data sinks for a given project.
+   * Update a data sink by ID.
    */
-  list(
-    query: DataSinkListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<DataSinkListResponse> {
-    return this._client.get('/api/v1/data-sinks', { query, ...options });
+  update(dataSinkID: string, body: DataSinkUpdateParams, options?: RequestOptions): APIPromise<DataSink> {
+    return this._client.put(path`/api/v1/data-sinks/${dataSinkID}`, { body, ...options });
   }
 
   /**
@@ -46,13 +53,6 @@ export class DataSinks extends APIResource {
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
-
-  /**
-   * Get a data sink by ID.
-   */
-  get(dataSinkID: string, options?: RequestOptions): APIPromise<DataSink> {
-    return this._client.get(path`/api/v1/data-sinks/${dataSinkID}`, options);
-  }
 }
 
 /**
@@ -84,7 +84,7 @@ export interface DataSink {
 
   project_id: string;
 
-  sink_type: 'PINECONE' | 'POSTGRES' | 'QDRANT' | 'AZUREAI_SEARCH' | 'MONGODB_ATLAS' | 'MILVUS' | 'ASTRA_DB';
+  sink_type: 'ASTRA_DB' | 'AZUREAI_SEARCH' | 'MILVUS' | 'MONGODB_ATLAS' | 'PINECONE' | 'POSTGRES' | 'QDRANT';
 
   /**
    * Creation datetime
@@ -99,6 +99,12 @@ export interface DataSink {
 
 export type DataSinkListResponse = Array<DataSink>;
 
+export interface DataSinkListParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
 export interface DataSinkCreateParams {
   /**
    * Body param: Component that implements the data sink
@@ -121,7 +127,7 @@ export interface DataSinkCreateParams {
   /**
    * Body param
    */
-  sink_type: 'PINECONE' | 'POSTGRES' | 'QDRANT' | 'AZUREAI_SEARCH' | 'MONGODB_ATLAS' | 'MILVUS' | 'ASTRA_DB';
+  sink_type: 'ASTRA_DB' | 'AZUREAI_SEARCH' | 'MILVUS' | 'MONGODB_ATLAS' | 'PINECONE' | 'POSTGRES' | 'QDRANT';
 
   /**
    * Query param
@@ -135,7 +141,7 @@ export interface DataSinkCreateParams {
 }
 
 export interface DataSinkUpdateParams {
-  sink_type: 'PINECONE' | 'POSTGRES' | 'QDRANT' | 'AZUREAI_SEARCH' | 'MONGODB_ATLAS' | 'MILVUS' | 'ASTRA_DB';
+  sink_type: 'ASTRA_DB' | 'AZUREAI_SEARCH' | 'MILVUS' | 'MONGODB_ATLAS' | 'PINECONE' | 'POSTGRES' | 'QDRANT';
 
   /**
    * Component that implements the data sink
@@ -157,18 +163,12 @@ export interface DataSinkUpdateParams {
   name?: string | null;
 }
 
-export interface DataSinkListParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
-}
-
 export declare namespace DataSinks {
   export {
     type DataSink as DataSink,
     type DataSinkListResponse as DataSinkListResponse,
+    type DataSinkListParams as DataSinkListParams,
     type DataSinkCreateParams as DataSinkCreateParams,
     type DataSinkUpdateParams as DataSinkUpdateParams,
-    type DataSinkListParams as DataSinkListParams,
   };
 }