@llamaindex/llama-cloud 2.8.0 → 2.9.0

package/src/resources/beta/sheets.ts

@@ -2,7 +2,6 @@
 
 import { APIResource } from '../../core/resource';
 import * as FilesAPI from '../files';
-import * as ParsingAPI from '../parsing';
 import { APIPromise } from '../../core/api-promise';
 import { PagePromise, PaginatedCursor, type PaginatedCursorParams } from '../../core/pagination';
 import { RequestOptions } from '../../internal/request-options';
@@ -11,8 +10,14 @@ import { pollUntilComplete, PollingOptions, DEFAULT_TIMEOUT } from '../../core/p
 
 export class Sheets extends APIResource {
   /**
-   * Create a spreadsheet parsing job. Experimental: not production-ready and subject
-   * to change.
+   * Create a spreadsheet parsing job.
+   *
+   * Provide at most one of `configuration` (an inline parsing configuration) or
+   * `configuration_id` (a saved configuration preset). If neither is provided, a
+   * default configuration is used. Optionally include `webhook_configurations` to
+   * receive `sheets.*` status notifications.
+   *
+   * Experimental: not production-ready and subject to change.
    *
    * @example
    * ```ts
@@ -244,7 +249,7 @@ export class Sheets extends APIResource {
 export type SheetsJobsPaginatedCursor = PaginatedCursor<SheetsJob>;
 
 /**
- * A spreadsheet parsing job
+ * A spreadsheet parsing job.
  */
 export interface SheetsJob {
   /**
@@ -253,9 +258,10 @@ export interface SheetsJob {
   id: string;
 
   /**
-   * Configuration for the parsing job
+   * Configuration applied to the parsing job (inline or resolved from a saved
+   * preset).
    */
-  config: SheetsParsingConfig;
+  configuration: SheetsParsingConfig;
 
   /**
    * When the job was created
@@ -275,7 +281,7 @@ export interface SheetsJob {
   /**
    * The status of the parsing job
    */
-  status: ParsingAPI.StatusEnum;
+  status: 'PENDING' | 'SUCCESS' | 'ERROR' | 'PARTIAL_SUCCESS' | 'CANCELLED';
 
   /**
    * When the job was last updated
@@ -287,6 +293,16 @@ export interface SheetsJob {
    */
   user_id: string;
 
+  /**
+   * @deprecated Configuration for spreadsheet parsing and region extraction
+   */
+  config?: SheetsParsingConfig | null;
+
+  /**
+   * The saved product configuration ID used at create time, if any.
+   */
+  configuration_id?: string | null;
+
   /**
    * Any errors encountered
    */
@@ -297,6 +313,17 @@ export interface SheetsJob {
    */
   file?: FilesAPI.File | null;
 
+  /**
+   * Per-status entry timestamps. Returned only when requested via
+   * `?expand=metadata_state_transitions`.
+   */
+  metadata_state_transitions?: { [key: string]: unknown } | null;
+
+  /**
+   * Job-time parameters such as webhook configurations.
+   */
+  parameters?: SheetsJob.Parameters;
+
   /**
    * All extracted regions (populated when job is complete)
    */
@@ -314,6 +341,68 @@ export interface SheetsJob {
 }
 
 export namespace SheetsJob {
+  /**
+   * Job-time parameters such as webhook configurations.
+   */
+  export interface Parameters {
+    /**
+     * Webhook configurations for job status notifications.
+     */
+    webhook_configurations?: Array<Parameters.WebhookConfiguration> | null;
+  }
+
+  export namespace Parameters {
+    /**
+     * Configuration for a single outbound webhook endpoint.
+     */
+    export interface WebhookConfiguration {
+      /**
+       * Events to subscribe to (e.g. 'parse.success', 'extract.error'). If null, all
+       * events are delivered.
+       */
+      webhook_events?: Array<
+        | 'extract.pending'
+        | 'extract.success'
+        | 'extract.error'
+        | 'extract.partial_success'
+        | 'extract.cancelled'
+        | '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.error'
+        | 'sheets.partial_success'
+        | 'sheets.cancelled'
+        | 'unmapped_event'
+      > | null;
+
+      /**
+       * Custom HTTP headers sent with each webhook request (e.g. auth tokens)
+       */
+      webhook_headers?: { [key: string]: string } | null;
+
+      /**
+       * Response format sent to the webhook: 'string' (default) or 'json'
+       */
+      webhook_output_format?: string | null;
+
+      /**
+       * URL to receive webhook POST notifications
+       */
+      webhook_url?: string | null;
+    }
+  }
+
   /**
    * A summary of a single extracted region from a spreadsheet
    */
@@ -442,12 +531,84 @@ export interface SheetCreateParams {
   project_id?: string | null;
 
   /**
-   * Body param: Configuration for the parsing job
+   * Body param: Configuration for spreadsheet parsing and region extraction
    */
-  config?: SheetsParsingConfig;
+  config?: SheetsParsingConfig | null;
+
+  /**
+   * Body param: Configuration for spreadsheet parsing and region extraction
+   */
+  configuration?: SheetsParsingConfig | null;
+
+  /**
+   * Body param: Saved configuration ID
+   */
+  configuration_id?: string | null;
+
+  /**
+   * Body param: Outbound webhook endpoints to notify on job status changes
+   */
+  webhook_configurations?: Array<SheetCreateParams.WebhookConfiguration> | null;
+}
+
+export namespace SheetCreateParams {
+  /**
+   * Configuration for a single outbound webhook endpoint.
+   */
+  export interface WebhookConfiguration {
+    /**
+     * Events to subscribe to (e.g. 'parse.success', 'extract.error'). If null, all
+     * events are delivered.
+     */
+    webhook_events?: Array<
+      | 'extract.pending'
+      | 'extract.success'
+      | 'extract.error'
+      | 'extract.partial_success'
+      | 'extract.cancelled'
+      | '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.error'
+      | 'sheets.partial_success'
+      | 'sheets.cancelled'
+      | 'unmapped_event'
+    > | null;
+
+    /**
+     * Custom HTTP headers sent with each webhook request (e.g. auth tokens)
+     */
+    webhook_headers?: { [key: string]: string } | null;
+
+    /**
+     * Response format sent to the webhook: 'string' (default) or 'json'
+     */
+    webhook_output_format?: string | null;
+
+    /**
+     * URL to receive webhook POST notifications
+     */
+    webhook_url?: string | null;
+  }
 }
 
 export interface SheetListParams extends PaginatedCursorParams {
+  /**
+   * Filter by saved configuration ID
+   */
+  configuration_id?: string | null;
+
   /**
    * Include items created at or after this timestamp (inclusive)
    */
@@ -472,7 +633,7 @@ export interface SheetListParams extends PaginatedCursorParams {
   /**
    * Filter by job status
    */
-  status?: ParsingAPI.StatusEnum | null;
+  status?: 'PENDING' | 'SUCCESS' | 'ERROR' | 'PARTIAL_SUCCESS' | 'CANCELLED' | null;
 }
 
 export interface SheetDeleteJobParams {
@@ -482,6 +643,12 @@ export interface SheetDeleteJobParams {
 }
 
 export interface SheetGetParams {
+  /**
+   * Optional fields to populate on the response. Valid values:
+   * metadata_state_transitions.
+   */
+  expand?: Array<string>;
+
   include_results?: boolean;
 
   organization_id?: string | null;

package/src/resources/classifier/jobs.ts

@@ -373,8 +373,9 @@ export namespace JobCreateParams {
   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;
 
@@ -384,6 +385,12 @@ export namespace JobCreateParams {
      */
     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?: 'string' | 'json' | null;
+
     /**
      * HTTPS URL to receive webhook POST requests. Must be publicly accessible
      */

package/src/resources/classify.ts

@@ -284,6 +284,63 @@ export interface ClassifyCreateRequest {
    * Idempotency key scoped to the project
    */
   transaction_id?: string | null;
+
+  /**
+   * Outbound webhook endpoints to notify on job status changes
+   */
+  webhook_configurations?: Array<ClassifyCreateRequest.WebhookConfiguration> | null;
+}
+
+export namespace ClassifyCreateRequest {
+  /**
+   * Configuration for a single outbound webhook endpoint.
+   */
+  export interface WebhookConfiguration {
+    /**
+     * Events to subscribe to (e.g. 'parse.success', 'extract.error'). If null, all
+     * events are delivered.
+     */
+    webhook_events?: Array<
+      | 'extract.pending'
+      | 'extract.success'
+      | 'extract.error'
+      | 'extract.partial_success'
+      | 'extract.cancelled'
+      | '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.error'
+      | 'sheets.partial_success'
+      | 'sheets.cancelled'
+      | 'unmapped_event'
+    > | null;
+
+    /**
+     * Custom HTTP headers sent with each webhook request (e.g. auth tokens)
+     */
+    webhook_headers?: { [key: string]: string } | null;
+
+    /**
+     * Response format sent to the webhook: 'string' (default) or 'json'
+     */
+    webhook_output_format?: string | null;
+
+    /**
+     * URL to receive webhook POST notifications
+     */
+    webhook_url?: string | null;
+  }
 }
 
 /**
@@ -571,6 +628,63 @@ export interface ClassifyCreateParams {
    * Body param: Idempotency key scoped to the project
    */
   transaction_id?: string | null;
+
+  /**
+   * Body param: Outbound webhook endpoints to notify on job status changes
+   */
+  webhook_configurations?: Array<ClassifyCreateParams.WebhookConfiguration> | null;
+}
+
+export namespace ClassifyCreateParams {
+  /**
+   * Configuration for a single outbound webhook endpoint.
+   */
+  export interface WebhookConfiguration {
+    /**
+     * Events to subscribe to (e.g. 'parse.success', 'extract.error'). If null, all
+     * events are delivered.
+     */
+    webhook_events?: Array<
+      | 'extract.pending'
+      | 'extract.success'
+      | 'extract.error'
+      | 'extract.partial_success'
+      | 'extract.cancelled'
+      | '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.error'
+      | 'sheets.partial_success'
+      | 'sheets.cancelled'
+      | 'unmapped_event'
+    > | null;
+
+    /**
+     * Custom HTTP headers sent with each webhook request (e.g. auth tokens)
+     */
+    webhook_headers?: { [key: string]: string } | null;
+
+    /**
+     * Response format sent to the webhook: 'string' (default) or 'json'
+     */
+    webhook_output_format?: string | null;
+
+    /**
+     * URL to receive webhook POST notifications
+     */
+    webhook_url?: string | null;
+  }
 }
 
 export interface ClassifyListParams extends PaginatedCursorParams {

package/src/resources/configurations.ts

@@ -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
@@ -403,6 +397,12 @@ export interface ExtractV2Parameters {
    * Extract tier: cost_effective (5 credits/page) or agentic (15 credits/page)
    */
   tier?: 'cost_effective' | 'agentic';
+
+  /**
+   * 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.
+   */
+  version?: string;
 }
 
 /**
@@ -426,11 +426,19 @@ export interface ParseV2Parameters {
   tier: 'fast' | 'cost_effective' | 'agentic' | 'agentic_plus';
 
   /**
-   * 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-05`
+   * - `agentic`: `2026-06-04`
+   * - `agentic_plus`: `2026-06-04`
+   *
+   * Full list: `GET /api/v2/parse/versions`.
    */
-  version: 'latest' | '2026-05-21' | '2026-04-09' | '2025-12-11' | (string & {});
+  version: 'latest' | '2026-06-05' | '2026-06-04' | '2025-12-11' | (string & {});
 
   /**
    * Options for AI-powered parsing tiers (cost_effective, agentic, agentic_plus).
@@ -665,6 +673,19 @@ 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'
@@ -1186,9 +1207,19 @@ export namespace ParseV2Parameters {
         tier?: 'fast' | 'cost_effective' | 'agentic' | 'agentic_plus' | 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-05`
+         * - `agentic`: `2026-06-04`
+         * - `agentic_plus`: `2026-06-04`
+         *
+         * Full list: `GET /api/v2/parse/versions`.
          */
-        version?: 'latest' | '2026-05-21' | '2026-04-09' | '2025-12-11' | (string & {}) | null;
+        version?: 'latest' | '2026-06-05' | '2026-06-04' | '2025-12-11' | (string & {}) | null;
       }
 
       export namespace ParsingConf {
@@ -1330,8 +1361,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 +1373,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?: 'string' | 'json' | null;
+
     /**
      * HTTPS URL to receive webhook POST requests. Must be publicly accessible
      */

package/src/resources/extract.ts

@@ -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
@@ -333,6 +327,12 @@ export interface ExtractConfiguration {
    * Extract tier: cost_effective (5 credits/page) or agentic (15 credits/page)
    */
   tier?: 'cost_effective' | 'agentic';
+
+  /**
+   * 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.
+   */
+  version?: string;
 }
 
 /**
@@ -502,10 +502,16 @@ export namespace ExtractV2JobCreate {
       | 'parse.partial_success'
       | 'parse.cancelled'
       | 'classify.pending'
+      | 'classify.running'
       | 'classify.success'
       | 'classify.error'
       | 'classify.partial_success'
       | 'classify.cancelled'
+      | 'sheets.pending'
+      | 'sheets.success'
+      | 'sheets.error'
+      | 'sheets.partial_success'
+      | 'sheets.cancelled'
       | 'unmapped_event'
     > | null;
 
@@ -686,10 +692,16 @@ export namespace ExtractCreateParams {
       | 'parse.partial_success'
       | 'parse.cancelled'
       | 'classify.pending'
+      | 'classify.running'
       | 'classify.success'
       | 'classify.error'
       | 'classify.partial_success'
       | 'classify.cancelled'
+      | 'sheets.pending'
+      | 'sheets.success'
+      | 'sheets.error'
+      | 'sheets.partial_success'
+      | 'sheets.cancelled'
       | 'unmapped_event'
     > | null;
 

package/src/resources/parsing.ts

@@ -1368,11 +1368,19 @@ export interface ParsingCreateParams {
   tier: 'fast' | 'cost_effective' | 'agentic' | 'agentic_plus';
 
   /**
-   * Body param: 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.
+   * Body param: 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-05`
+   * - `agentic`: `2026-06-04`
+   * - `agentic_plus`: `2026-06-04`
+   *
+   * Full list: `GET /api/v2/parse/versions`.
    */
-  version: 'latest' | '2026-05-21' | '2026-04-09' | '2025-12-11' | (string & {});
+  version: 'latest' | '2026-06-05' | '2026-06-04' | '2025-12-11' | (string & {});
 
   /**
    * Query param
@@ -1635,6 +1643,19 @@ export namespace ParsingCreateParams {
      */
     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'
@@ -2156,9 +2177,19 @@ export namespace ParsingCreateParams {
         tier?: 'fast' | 'cost_effective' | 'agentic' | 'agentic_plus' | 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-05`
+         * - `agentic`: `2026-06-04`
+         * - `agentic_plus`: `2026-06-04`
+         *
+         * Full list: `GET /api/v2/parse/versions`.
          */
-        version?: 'latest' | '2026-05-21' | '2026-04-09' | '2025-12-11' | (string & {}) | null;
+        version?: 'latest' | '2026-06-05' | '2026-06-04' | '2025-12-11' | (string & {}) | null;
       }
 
       export namespace ParsingConf {
@@ -2300,8 +2331,9 @@ export namespace ParsingCreateParams {
   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;
 
@@ -2311,6 +2343,12 @@ export namespace ParsingCreateParams {
      */
     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?: 'string' | 'json' | null;
+
     /**
      * HTTPS URL to receive webhook POST requests. Must be publicly accessible
      */