@llamaindex/llama-cloud 2.8.0 → 2.9.1

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).
@@ -359,12 +359,6 @@ export interface ExtractV2Parameters {
    */
   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
@@ -402,7 +396,15 @@ 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. 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,14 +425,22 @@ 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';
 
   /**
-   * Tier version. Use 'latest' for the current stable version, or pin a dated
-   * version for reproducible results. See GET /api/v2/parse/versions for the
-   * per-tier list.
+   * Version for the selected tier. Use `latest`, or pin one of that tier's dated
+   * versions.
+   *
+   * Current `latest` by tier:
+   *
+   * - `fast`: `2025-12-11`
+   * - `cost_effective`: `2026-06-18`
+   * - `agentic`: `2026-06-18`
+   * - `agentic_plus`: `2026-06-18`
+   *
+   * Full list: `GET /api/v2/parse/versions`.
    */
-  version: 'latest' | '2026-05-21' | '2026-04-09' | '2025-12-11' | (string & {});
+  version: 'latest' | '2026-06-18' | '2025-12-11' | (string & {});
 
   /**
    * Options for AI-powered parsing tiers (cost_effective, agentic, agentic_plus).
@@ -557,6 +567,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)
      */
@@ -596,6 +611,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)
      */
@@ -665,13 +694,26 @@ export namespace ParseV2Parameters {
      */
     extract_printed_page_number?: boolean | null;
 
+    /**
+     * Bounding-box granularity levels to compute for the parse. 'word' computes one
+     * bounding box per detected word; 'line' computes one per text line; 'cell'
+     * computes one per table cell. Multiple levels can be requested. Empty list
+     * (default) disables granular bboxes — only item-level layout boxes are returned
+     * on the result. When set, the computed boxes are not inlined on the result items;
+     * they are written to a separate `grounded_items` sidecar (JSONL, one row per
+     * page) and exposed as `result_content_metadata.grounded_items` (a presigned
+     * download URL) on the parse result. Each row matches the `GroundedJsonItem`
+     * shape.
+     */
+    granular_bboxes?: Array<'cell' | 'line' | 'word'>;
+
     /**
      * Image categories to extract and save. Options: 'screenshot' (full page renders
      * useful for visual QA), 'embedded' (images found within the document), 'layout'
      * (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
@@ -921,7 +963,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 {
@@ -1178,17 +1220,27 @@ 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;
 
         /**
-         * Tier version when overriding tier. Required when tier is specified
+         * Version for the override tier. Required when `tier` is set. Use `latest`, or pin
+         * one of that tier's dated versions.
+         *
+         * Current `latest` by tier:
+         *
+         * - `fast`: `2025-12-11`
+         * - `cost_effective`: `2026-06-18`
+         * - `agentic`: `2026-06-18`
+         * - `agentic_plus`: `2026-06-18`
+         *
+         * Full list: `GET /api/v2/parse/versions`.
          */
-        version?: 'latest' | '2026-05-21' | '2026-04-09' | '2025-12-11' | (string & {}) | null;
+        version?: 'latest' | '2026-06-18' | '2025-12-11' | (string & {}) | null;
       }
 
       export namespace ParsingConf {
@@ -1330,8 +1382,9 @@ export namespace ParseV2Parameters {
   export interface WebhookConfiguration {
     /**
      * Events that trigger this webhook. Options: 'parse.success' (job completed),
-     * 'parse.failure' (job failed), 'parse.partial' (some pages failed). If not
-     * specified, webhook fires for all events
+     * 'parse.error' (job failed), 'parse.partial_success' (some pages failed),
+     * 'parse.pending', 'parse.running', 'parse.cancelled'. If not specified, webhook
+     * fires for all events
      */
     webhook_events?: Array<string> | null;
 
@@ -1341,6 +1394,12 @@ export namespace ParseV2Parameters {
      */
     webhook_headers?: { [key: string]: unknown } | null;
 
+    /**
+     * 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?: 'json' | 'string' | null;
+
     /**
      * HTTPS URL to receive webhook POST requests. Must be publicly accessible
      */
@@ -1379,7 +1438,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';
   }
 }
 
@@ -1407,10 +1466,10 @@ export interface ConfigurationCreateParams {
    * Body param: Product-specific configuration parameters.
    */
   parameters:
-    | SplitV1Parameters
-    | ExtractV2Parameters
     | ClassifyV2Parameters
+    | ExtractV2Parameters
     | ParseV2Parameters
+    | SplitV1Parameters
     | ConfigurationCreateParams.SpreadsheetV1Parameters
     | UntypedParameters;
 
@@ -1485,6 +1544,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;
 
@@ -1511,10 +1593,10 @@ export interface ConfigurationUpdateParams {
    * Body param: Updated parameters (omit to leave unchanged).
    */
   parameters?:
-    | SplitV1Parameters
-    | ExtractV2Parameters
     | ClassifyV2Parameters
+    | ExtractV2Parameters
     | ParseV2Parameters
+    | SplitV1Parameters
     | ConfigurationUpdateParams.SpreadsheetV1Parameters
     | UntypedParameters
     | null;
@@ -1580,29 +1662,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;
 
@@ -1620,9 +1679,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,
   };
 }

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,
   };
 }