@llamaindex/llama-cloud 2.4.1 → 2.9.0

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,19 @@ 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: 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 & {});
 
   /**
    * Query param
@@ -1642,12 +1619,43 @@ 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
      */
     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'
@@ -1844,7 +1852,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;
@@ -2169,50 +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?:
-          | '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 {
@@ -2354,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;
 
@@ -2365,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
      */
@@ -2402,8 +2386,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/pipelines/pipelines.ts

@@ -928,10 +928,16 @@ export namespace LlamaParseParameters {
       | '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/projects.ts

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

package/src/resources/shared.ts

@@ -546,7 +546,7 @@ export interface CloudSharepointDataSource {
   /**
    * Whether to get permissions for the sharepoint site.
    */
-  get_permissions?: boolean | null;
+  get_permissions?: boolean;
 
   /**
    * List of regex patterns for file paths to include. Full paths (including

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '2.4.1'; // x-release-please-version
+export const VERSION = '2.9.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.1";
+export declare const VERSION = "2.9.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "2.4.1";
+export declare const VERSION = "2.9.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.1'; // x-release-please-version
+exports.VERSION = '2.9.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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