@llamaindex/llama-cloud 2.4.1 → 2.9.0

package/src/resources/configurations.ts

@@ -11,10 +11,8 @@ import { path } from '../internal/utils/path';
 
 export class Configurations extends APIResource {
   /**
-   * Create or update a product configuration.
-   *
-   * If a configuration with the same name already exists for this product type and
-   * project, it will be updated (upsert semantics).
+   * Upsert a product configuration; updates if one with the same name + product
+   * type + project exists, otherwise creates.
    */
   create(params: ConfigurationCreateParams, options?: RequestOptions): APIPromise<ConfigurationResponse> {
     const { organization_id, project_id, ...body } = params;
@@ -361,11 +359,6 @@ export interface ExtractV2Parameters {
    */
   confidence_scores?: boolean;
 
-  /**
-   * Extract algorithm version. Use 'latest' or a date string.
-   */
-  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
@@ -404,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;
 }
 
 /**
@@ -427,50 +426,19 @@ export interface ParseV2Parameters {
   tier: 'fast' | 'cost_effective' | 'agentic' | 'agentic_plus';
 
   /**
-   * Tier version. Use 'latest' for the current stable version, or specify a specific
-   * version (e.g., '1.0', '2.0') for reproducible results
-   */
-  version:
-    | '2025-12-11'
-    | '2025-12-18'
-    | '2025-12-31'
-    | '2026-01-08'
-    | '2026-01-09'
-    | '2026-01-16'
-    | '2026-01-21'
-    | '2026-01-22'
-    | '2026-01-24'
-    | '2026-01-29'
-    | '2026-01-30'
-    | '2026-02-03'
-    | '2026-02-18'
-    | '2026-02-20'
-    | '2026-02-24'
-    | '2026-02-26'
-    | '2026-03-02'
-    | '2026-03-03'
-    | '2026-03-04'
-    | '2026-03-05'
-    | '2026-03-09'
-    | '2026-03-10'
-    | '2026-03-11'
-    | '2026-03-12'
-    | '2026-03-17'
-    | '2026-03-19'
-    | '2026-03-20'
-    | '2026-03-22'
-    | '2026-03-23'
-    | '2026-03-24'
-    | '2026-03-25'
-    | '2026-03-26'
-    | '2026-03-27'
-    | '2026-03-30'
-    | '2026-03-31'
-    | '2026-04-02'
-    | '2026-04-06'
-    | '2026-04-09'
-    | 'latest'
-    | (string & {});
+   * 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-06-05' | '2026-06-04' | '2025-12-11' | (string & {});
 
   /**
    * Options for AI-powered parsing tiers (cost_effective, agentic, agentic_plus).
@@ -681,12 +649,43 @@ export namespace ParseV2Parameters {
    * Output formatting options for markdown, text, and extracted images
    */
   export interface OutputOptions {
+    /**
+     * Optional additional output artifacts to save alongside the primary parse output.
+     * Each value opts in to generating and persisting one extra file; the empty list
+     * (default) saves none. The three accepted values are: 'stripped_md' — per-page
+     * markdown stripped of formatting (links, bold/italic, images, HTML), saved as
+     * JSON for full-text-search indexing; fetch via
+     * `expand=stripped_markdown_content_metadata`. 'concatenated_stripped_txt' — all
+     * stripped pages concatenated into a single plain-text file with `\n\n---\n\n`
+     * between pages, useful for feeding the document into search or embedding
+     * pipelines as one blob; fetch via
+     * `expand=concatenated_stripped_markdown_content_metadata`. 'word_bbox' — raw
+     * word-level bounding boxes (one JSON object per word, with page number and
+     * x/y/w/h coordinates) saved as JSONL, useful for highlighting or grounding
+     * extracted answers back to the source document; fetch via
+     * `expand=raw_words_content_metadata`.
+     */
+    additional_outputs?: Array<string>;
+
     /**
      * Extract the printed page number as it appears in the document (e.g., 'Page 5 of
      * 10', 'v', 'A-3'). Useful for referencing original page numbers
      */
     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'
@@ -883,7 +882,7 @@ export namespace ParseV2Parameters {
      */
     export interface Timeouts {
       /**
-       * Base timeout for the job in seconds (max 1800 = 30 minutes). This is the minimum
+       * Base timeout for the job in seconds (max 7200 = 2 hours). This is the minimum
        * time allowed regardless of document size
        */
       base_in_seconds?: number | null;
@@ -1208,50 +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?:
-          | '2025-12-11'
-          | '2025-12-18'
-          | '2025-12-31'
-          | '2026-01-08'
-          | '2026-01-09'
-          | '2026-01-16'
-          | '2026-01-21'
-          | '2026-01-22'
-          | '2026-01-24'
-          | '2026-01-29'
-          | '2026-01-30'
-          | '2026-02-03'
-          | '2026-02-18'
-          | '2026-02-20'
-          | '2026-02-24'
-          | '2026-02-26'
-          | '2026-03-02'
-          | '2026-03-03'
-          | '2026-03-04'
-          | '2026-03-05'
-          | '2026-03-09'
-          | '2026-03-10'
-          | '2026-03-11'
-          | '2026-03-12'
-          | '2026-03-17'
-          | '2026-03-19'
-          | '2026-03-20'
-          | '2026-03-22'
-          | '2026-03-23'
-          | '2026-03-24'
-          | '2026-03-25'
-          | '2026-03-26'
-          | '2026-03-27'
-          | '2026-03-30'
-          | '2026-03-31'
-          | '2026-04-02'
-          | '2026-04-06'
-          | '2026-04-09'
-          | 'latest'
-          | (string & {})
-          | null;
+        version?: 'latest' | '2026-06-05' | '2026-06-04' | '2025-12-11' | (string & {}) | null;
       }
 
       export namespace ParsingConf {
@@ -1393,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;
 
@@ -1404,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,11 +289,6 @@ export interface ExtractConfiguration {
    */
   confidence_scores?: boolean;
 
-  /**
-   * Extract algorithm version. Use 'latest' or a date string.
-   */
-  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,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;
 }
 
 /**
@@ -358,16 +359,6 @@ export interface ExtractJobMetadata {
  * Extraction usage metrics.
  */
 export interface ExtractJobUsage {
-  /**
-   * Number of document tokens
-   */
-  num_document_tokens?: number | null;
-
-  /**
-   * Number of output tokens
-   */
-  num_output_tokens?: number | null;
-
   /**
    * Number of pages extracted
    */
@@ -511,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;
 
@@ -695,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/files.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as FilesAPI from './files';
 import { APIPromise } from '../core/api-promise';
 import { PagePromise, PaginatedCursor, type PaginatedCursorParams } from '../core/pagination';
 import { type Uploadable } from '../core/uploads';
@@ -71,14 +72,7 @@ export class Files extends APIResource {
   }
 
   /**
-   * Query files with flexible filtering and pagination.
-   *
-   * **Deprecated**: Use GET /files instead for listing files with query parameters.
-   *
-   * Args: request: The query request with filters and pagination project: Validated
-   * project from dependency
-   *
-   * Returns: Paginated response with files
+   * Query files with filtering and pagination. Deprecated: use `GET /files`.
    *
    * @deprecated Use the GET /files endpoint instead
    */
@@ -171,57 +165,6 @@ export interface File {
   updated_at?: string | null;
 }
 
-/**
- * Schema for creating a file.
- */
-export interface FileCreate {
-  /**
-   * Name that will be used for created file. If possible, always include the file
-   * extension in the name.
-   */
-  name: string;
-
-  /**
-   * The ID of the data source that the file belongs to
-   */
-  data_source_id?: string | null;
-
-  /**
-   * The ID of the file in the external system
-   */
-  external_file_id?: string | null;
-
-  /**
-   * Size of the file in bytes
-   */
-  file_size?: number | null;
-
-  /**
-   * The last modified time of the file
-   */
-  last_modified_at?: string | null;
-
-  /**
-   * Permission information for the file
-   */
-  permission_info?: {
-    [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null;
-  } | null;
-
-  /**
-   * Resource information for the file
-   */
-  resource_info?: {
-    [key: string]: { [key: string]: unknown } | Array<unknown> | string | number | boolean | null;
-  } | null;
-
-  /**
-   * Storage type for the file. Valid values: 'Ephemeral', 'Permanent' (no
-   * expiration). If not specified, defaults to permanent storage.
-   */
-  storage_type?: 'ephemeral' | 'permanent' | (string & {});
-}
-
 /**
  * Schema for a presigned URL.
  */
@@ -261,6 +204,11 @@ export interface FileCreateResponse {
    */
   project_id: string;
 
+  /**
+   * Schema for a presigned URL.
+   */
+  download_url?: PresignedURL | null;
+
   /**
    * When the file expires and may be automatically removed. Null means no
    * expiration.
@@ -308,6 +256,11 @@ export interface FileListResponse {
    */
   project_id: string;
 
+  /**
+   * Schema for a presigned URL.
+   */
+  download_url?: PresignedURL | null;
+
   /**
    * When the file expires and may be automatically removed. Null means no
    * expiration.
@@ -379,6 +332,11 @@ export namespace FileQueryResponse {
      */
     project_id: string;
 
+    /**
+     * Schema for a presigned URL.
+     */
+    download_url?: FilesAPI.PresignedURL | null;
+
     /**
      * When the file expires and may be automatically removed. Null means no
      * expiration.
@@ -438,6 +396,11 @@ export interface FileCreateParams {
 }
 
 export interface FileListParams extends PaginatedCursorParams {
+  /**
+   * Fields to expand on each file.
+   */
+  expand?: Array<string> | null;
+
   /**
    * Filter by external file ID.
    */
@@ -554,7 +517,6 @@ export namespace FileQueryParams {
 export declare namespace Files {
   export {
     type File as File,
-    type FileCreate as FileCreate,
     type PresignedURL as PresignedURL,
     type FileCreateResponse as FileCreateResponse,
     type FileListResponse as FileListResponse,

package/src/resources/index.ts

@@ -1,6 +1,16 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export * from './shared';
+export {
+  Batches,
+  type BatchCreateResponse,
+  type BatchListResponse,
+  type BatchGetResponse,
+  type BatchCreateParams,
+  type BatchListParams,
+  type BatchGetParams,
+  type BatchListResponsesPaginatedCursor,
+} from './batches';
 export { Beta } from './beta/beta';
 export { Classifier } from './classifier/classifier';
 export {
@@ -73,7 +83,6 @@ export {
 export {
   Files,
   type File,
-  type FileCreate,
   type PresignedURL,
   type FileCreateResponse,
   type FileListResponse,