@llamaindex/llama-cloud 2.4.0 → 2.8.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;
@@ -362,7 +360,8 @@ export interface ExtractV2Parameters {
   confidence_scores?: boolean;
 
   /**
-   * Extract algorithm version. Use 'latest' or a date string.
+   * 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;
 
@@ -427,50 +426,11 @@ 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 & {});
+   * 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: 'latest' | '2026-05-21' | '2026-04-09' | '2025-12-11' | (string & {});
 
   /**
    * Options for AI-powered parsing tiers (cost_effective, agentic, agentic_plus).
@@ -681,6 +641,24 @@ 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
@@ -883,7 +861,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;
@@ -1210,48 +1188,7 @@ export namespace ParseV2Parameters {
         /**
          * Tier version when overriding tier. Required when tier is specified
          */
-        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-05-21' | '2026-04-09' | '2025-12-11' | (string & {}) | null;
       }
 
       export namespace ParsingConf {

package/src/resources/extract.ts

@@ -290,7 +290,8 @@ export interface ExtractConfiguration {
   confidence_scores?: boolean;
 
   /**
-   * Extract algorithm version. Use 'latest' or a date string.
+   * 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;
 
@@ -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
    */

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,

package/src/resources/parsing.ts

@@ -285,6 +285,11 @@ export interface BBox {
    */
   label?: string | null;
 
+  /**
+   * Optional visual text rotation angle in degrees. Omitted when unrotated.
+   */
+  r?: number | null;
+
   /**
    * Start index in the text
    */
@@ -548,6 +553,8 @@ export type LlamaParseSupportedFileExtensions =
   | '.vdx'
   | '.bmp'
   | '.gif'
+  | '.heic'
+  | '.heif'
   | '.jpg'
   | '.jpeg'
   | '.png'
@@ -622,7 +629,8 @@ export type LlamaParseSupportedFileExtensions =
   | '.mpeg'
   | '.mpga'
   | '.wav'
-  | '.webm';
+  | '.webm'
+  | '.yxmd';
 
 /**
  * A parse job (v1).
@@ -1360,50 +1368,11 @@ export interface ParsingCreateParams {
   tier: 'fast' | 'cost_effective' | 'agentic' | 'agentic_plus';
 
   /**
-   * Body param: 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 & {});
+   * 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.
+   */
+  version: 'latest' | '2026-05-21' | '2026-04-09' | '2025-12-11' | (string & {});
 
   /**
    * Query param
@@ -1642,6 +1611,24 @@ export namespace ParsingCreateParams {
    * 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
@@ -1844,7 +1831,7 @@ export namespace ParsingCreateParams {
      */
     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;
@@ -2171,48 +2158,7 @@ export namespace ParsingCreateParams {
         /**
          * Tier version when overriding tier. Required when tier is specified
          */
-        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-05-21' | '2026-04-09' | '2025-12-11' | (string & {}) | null;
       }
 
       export namespace ParsingConf {
@@ -2402,8 +2348,9 @@ export interface ParsingGetParams {
   /**
    * Fields to include: text, markdown, items, metadata, job_metadata,
    * text_content_metadata, markdown_content_metadata, items_content_metadata,
-   * metadata_content_metadata, xlsx_content_metadata, output_pdf_content_metadata,
-   * images_content_metadata. Metadata fields include presigned URLs.
+   * metadata_content_metadata, raw_words_content_metadata, xlsx_content_metadata,
+   * output_pdf_content_metadata, images_content_metadata. Metadata fields include
+   * presigned URLs.
    */
   expand?: Array<string>;
 

package/src/resources/pipelines/data-sources.ts

@@ -47,8 +47,8 @@ export class DataSources extends APIResource {
   }
 
   /**
-   * Run ingestion for the pipeline data source by incrementally updating the
-   * data-sink with upstream changes from data-source.
+   * Run incremental ingestion: pull upstream changes from the data source into the
+   * data sink.
    */
   sync(
     dataSourceID: string,

package/src/resources/pipelines/documents.ts

@@ -41,10 +41,8 @@ export class Documents extends APIResource {
   }
 
   /**
-   * Delete a document from a pipeline. Initiates an async job that will:
-   *
-   * 1. Delete vectors from the vector store
-   * 2. Delete the document from MongoDB after vectors are successfully deleted
+   * Delete a document from a pipeline; runs async (vectors first, then MongoDB
+   * record).
    */
   delete(documentID: string, params: DocumentDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { pipeline_id } = params;

package/src/resources/projects.ts

@@ -44,8 +44,6 @@ export interface Project {
    */
   organization_id: string;
 
-  ad_hoc_eval_dataset_id?: string | null;
-
   /**
    * Creation datetime
    */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.4.0'; // x-release-please-version
+export const VERSION = '2.8.0'; // x-release-please-version

package/uploads.d.mts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/uploads.d.ts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.js";
 //# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,kCAA+B"}

package/uploads.mjs

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.4.0";
+export declare const VERSION = "2.8.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.4.0";
+export declare const VERSION = "2.8.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '2.4.0'; // x-release-please-version
+exports.VERSION = '2.8.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '2.4.0'; // x-release-please-version
+export const VERSION = '2.8.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map