@llamaindex/llama-cloud 1.8.0 → 2.1.0

package/src/client.ts

@@ -25,8 +25,6 @@ import {
   type PaginatedCursorPostParams,
   PaginatedCursorPostResponse,
   PaginatedCursorResponse,
-  type PaginatedExtractRunsParams,
-  PaginatedExtractRunsResponse,
   type PaginatedJobsHistoryParams,
   PaginatedJobsHistoryResponse,
   type PaginatedPipelineFilesParams,
@@ -67,6 +65,28 @@ import {
   DataSourceUpdateParams,
   DataSources,
 } from './resources/data-sources';
+import {
+  Extract,
+  ExtractConfiguration,
+  ExtractCreateParams,
+  ExtractDeleteParams,
+  ExtractDeleteResponse,
+  ExtractGenerateSchemaParams,
+  ExtractGenerateSchemaResponse,
+  ExtractGetParams,
+  ExtractJobMetadata,
+  ExtractJobUsage,
+  ExtractListParams,
+  ExtractV2Job,
+  ExtractV2JobCreate,
+  ExtractV2JobQueryResponse,
+  ExtractV2JobsPaginatedCursor,
+  ExtractV2SchemaGenerateRequest,
+  ExtractV2SchemaValidateRequest,
+  ExtractV2SchemaValidateResponse,
+  ExtractValidateSchemaParams,
+  ExtractedFieldMetadata,
+} from './resources/extract';
 import {
   File,
   FileCreate,
@@ -117,7 +137,6 @@ import {
 } from './resources/projects';
 import { Beta } from './resources/beta/beta';
 import { Classifier } from './resources/classifier/classifier';
-import { Extraction, ExtractionRunParams } from './resources/extraction/extraction';
 import {
   AdvancedModeTransformConfig,
   AutoTransformConfig,
@@ -326,7 +345,7 @@ export class LlamaCloud {
       parseLogLevel(readEnv('LLAMA_CLOUD_LOG'), "process.env['LLAMA_CLOUD_LOG']", this) ??
       defaultLogLevel;
     this.fetchOptions = options.fetchOptions;
-    this.maxRetries = options.maxRetries ?? 2;
+    this.maxRetries = options.maxRetries ?? 5;
     this.fetch = options.fetch ?? Shims.getDefaultFetch();
     this.#encoder = Opts.FallbackEncoder;
 
@@ -409,8 +428,9 @@ export class LlamaCloud {
       : new URL(baseURL + (baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
 
     const defaultQuery = this.defaultQuery();
-    if (!isEmptyObj(defaultQuery)) {
-      query = { ...defaultQuery, ...query };
+    const pathQuery = Object.fromEntries(url.searchParams);
+    if (!isEmptyObj(defaultQuery) || !isEmptyObj(pathQuery)) {
+      query = { ...pathQuery, ...defaultQuery, ...query };
     }
 
     if (typeof query === 'object' && query && !Array.isArray(query)) {
@@ -905,7 +925,7 @@ export class LlamaCloud {
 
   files: API.Files = new API.Files(this);
   parsing: API.Parsing = new API.Parsing(this);
-  extraction: API.Extraction = new API.Extraction(this);
+  extract: API.Extract = new API.Extract(this);
   classifier: API.Classifier = new API.Classifier(this);
   classify: API.Classify = new API.Classify(this);
   projects: API.Projects = new API.Projects(this);
@@ -918,7 +938,7 @@ export class LlamaCloud {
 
 LlamaCloud.Files = Files;
 LlamaCloud.Parsing = Parsing;
-LlamaCloud.Extraction = Extraction;
+LlamaCloud.Extract = Extract;
 LlamaCloud.Classifier = Classifier;
 LlamaCloud.Classify = Classify;
 LlamaCloud.Projects = Projects;
@@ -949,12 +969,6 @@ export declare namespace LlamaCloud {
     type PaginatedBatchItemsResponse as PaginatedBatchItemsResponse,
   };
 
-  export import PaginatedExtractRuns = Pagination.PaginatedExtractRuns;
-  export {
-    type PaginatedExtractRunsParams as PaginatedExtractRunsParams,
-    type PaginatedExtractRunsResponse as PaginatedExtractRunsResponse,
-  };
-
   export import PaginatedCloudDocuments = Pagination.PaginatedCloudDocuments;
   export {
     type PaginatedCloudDocumentsParams as PaginatedCloudDocumentsParams,
@@ -1022,7 +1036,28 @@ export declare namespace LlamaCloud {
     type ParsingGetParams as ParsingGetParams,
   };
 
-  export { Extraction as Extraction, type ExtractionRunParams as ExtractionRunParams };
+  export {
+    Extract as Extract,
+    type ExtractConfiguration as ExtractConfiguration,
+    type ExtractJobMetadata as ExtractJobMetadata,
+    type ExtractJobUsage as ExtractJobUsage,
+    type ExtractV2Job as ExtractV2Job,
+    type ExtractV2JobCreate as ExtractV2JobCreate,
+    type ExtractV2JobQueryResponse as ExtractV2JobQueryResponse,
+    type ExtractV2SchemaGenerateRequest as ExtractV2SchemaGenerateRequest,
+    type ExtractV2SchemaValidateRequest as ExtractV2SchemaValidateRequest,
+    type ExtractV2SchemaValidateResponse as ExtractV2SchemaValidateResponse,
+    type ExtractedFieldMetadata as ExtractedFieldMetadata,
+    type ExtractDeleteResponse as ExtractDeleteResponse,
+    type ExtractGenerateSchemaResponse as ExtractGenerateSchemaResponse,
+    type ExtractV2JobsPaginatedCursor as ExtractV2JobsPaginatedCursor,
+    type ExtractCreateParams as ExtractCreateParams,
+    type ExtractListParams as ExtractListParams,
+    type ExtractDeleteParams as ExtractDeleteParams,
+    type ExtractGenerateSchemaParams as ExtractGenerateSchemaParams,
+    type ExtractGetParams as ExtractGetParams,
+    type ExtractValidateSchemaParams as ExtractValidateSchemaParams,
+  };
 
   export { Classifier as Classifier };
 

package/src/core/pagination.ts

@@ -315,77 +315,6 @@ export class PaginatedBatchItems<Item>
   }
 }
 
-export interface PaginatedExtractRunsResponse<Item> {
-  items: Array<Item>;
-
-  total: number;
-
-  skip: number;
-}
-
-export interface PaginatedExtractRunsParams {
-  /**
-   * Number of extraction runs to skip
-   */
-  skip?: number;
-
-  /**
-   * Maximum number of extraction runs to return
-   */
-  limit?: number;
-}
-
-export class PaginatedExtractRuns<Item>
-  extends AbstractPage<Item>
-  implements PaginatedExtractRunsResponse<Item>
-{
-  items: Array<Item>;
-
-  total: number;
-
-  skip: number;
-
-  constructor(
-    client: LlamaCloud,
-    response: Response,
-    body: PaginatedExtractRunsResponse<Item>,
-    options: FinalRequestOptions,
-  ) {
-    super(client, response, body, options);
-
-    this.items = body.items || [];
-    this.total = body.total || 0;
-    this.skip = body.skip || 0;
-  }
-
-  getPaginatedItems(): Item[] {
-    return this.items ?? [];
-  }
-
-  nextPageRequestOptions(): PageRequestOptions | null {
-    const offset = this.skip ?? 0;
-    const length = this.getPaginatedItems().length;
-    const currentCount = offset + length;
-
-    const totalCount = this.total;
-    if (!totalCount) {
-      return null;
-    }
-
-    if (currentCount < totalCount) {
-      return {
-        ...this.options,
-        query: {
-          ...maybeObj(this.options.query),
-          skip: currentCount,
-        },
-      };
-    }
-
-    return null;
-  }
-}
-
 export interface PaginatedCloudDocumentsResponse<Item> {
   documents: Array<Item>;
 

package/src/resources/beta/batch/batch.ts

@@ -3,7 +3,6 @@
 import { APIResource } from '../../../core/resource';
 import * as ParsingAPI from '../../parsing';
 import * as JobsAPI from '../../classifier/jobs';
-import * as ExtractionJobsAPI from '../../extraction/jobs';
 import * as JobItemsAPI from './job-items';
 import {
   JobItemGetProcessingResultsParams,
@@ -23,11 +22,14 @@ export class Batch extends APIResource {
   jobItems: JobItemsAPI.JobItems = new JobItemsAPI.JobItems(this._client);
 
   /**
-   * Create a new batch processing job for a directory.
+   * Create a batch processing job.
    *
-   * Processes all files in the specified directory according to the job
-   * configuration. The job runs asynchronously and you can monitor progress using
-   * the job status endpoint.
+   * Processes files from a directory or a specific list of item IDs. Supports batch
+   * parsing and classification operations.
+   *
+   * Provide either `directory_id` to process all files in a directory, or `item_ids`
+   * for specific items. The job runs asynchronously — poll `GET /batch/{job_id}` for
+   * progress.
    */
   create(params: BatchCreateParams, options?: RequestOptions): APIPromise<BatchCreateResponse> {
     const { organization_id, project_id, 'temporal-namespace': temporalNamespace, ...body } = params;
@@ -43,11 +45,10 @@ export class Batch extends APIResource {
   }
 
   /**
-   * List all batch processing jobs for a project with optional filtering.
+   * List batch processing jobs with optional filtering.
    *
-   * Returns a paginated list of batch jobs with filters for directory, job type, and
-   * status. Useful for viewing job history, monitoring progress, and finding
-   * specific jobs.
+   * Filter by `directory_id`, `job_type`, or `status`. Results are paginated with
+   * configurable `limit` and `offset`.
    */
   list(
     query: BatchListParams | null | undefined = {},
@@ -62,8 +63,8 @@ export class Batch extends APIResource {
   /**
    * Cancel a running batch processing job.
    *
-   * Stops processing and marks all pending items as cancelled. Items currently being
-   * processed may complete depending on their state.
+   * Stops processing and marks pending items as cancelled. Items currently being
+   * processed may still complete.
    */
   cancel(
     jobID: string,
@@ -85,7 +86,8 @@ export class Batch extends APIResource {
   /**
    * Get detailed status of a batch processing job.
    *
-   * Returns current progress, file counts, and estimated completion time.
+   * Returns current progress percentage, file counts (total, processed, failed,
+   * skipped), and timestamps.
    */
   getStatus(
     jobID: string,
@@ -108,7 +110,7 @@ export interface BatchCreateResponse {
   id: string;
 
   /**
-   * Type of processing operation
+   * Type of processing operation (parse or classify)
    */
   job_type: 'parse' | 'extract' | 'classify';
 
@@ -118,7 +120,7 @@ export interface BatchCreateResponse {
   project_id: string;
 
   /**
-   * Current status of the job
+   * Current job status
    */
   status: 'pending' | 'running' | 'dispatched' | 'completed' | 'failed' | 'cancelled';
 
@@ -180,7 +182,7 @@ export interface BatchCreateResponse {
   updated_at?: string | null;
 
   /**
-   * Temporal workflow ID for this batch job
+   * Async job tracking ID
    */
   workflow_id?: string | null;
 }
@@ -195,7 +197,7 @@ export interface BatchListResponse {
   id: string;
 
   /**
-   * Type of processing operation
+   * Type of processing operation (parse or classify)
    */
   job_type: 'parse' | 'extract' | 'classify';
 
@@ -205,7 +207,7 @@ export interface BatchListResponse {
   project_id: string;
 
   /**
-   * Current status of the job
+   * Current job status
    */
   status: 'pending' | 'running' | 'dispatched' | 'completed' | 'failed' | 'cancelled';
 
@@ -267,7 +269,7 @@ export interface BatchListResponse {
   updated_at?: string | null;
 
   /**
-   * Temporal workflow ID for this batch job
+   * Async job tracking ID
    */
   workflow_id?: string | null;
 }
@@ -323,7 +325,7 @@ export namespace BatchGetStatusResponse {
     id: string;
 
     /**
-     * Type of processing operation
+     * Type of processing operation (parse or classify)
      */
     job_type: 'parse' | 'extract' | 'classify';
 
@@ -333,7 +335,7 @@ export namespace BatchGetStatusResponse {
     project_id: string;
 
     /**
-     * Current status of the job
+     * Current job status
      */
     status: 'pending' | 'running' | 'dispatched' | 'completed' | 'failed' | 'cancelled';
 
@@ -395,7 +397,7 @@ export namespace BatchGetStatusResponse {
     updated_at?: string | null;
 
     /**
-     * Temporal workflow ID for this batch job
+     * Async job tracking ID
      */
     workflow_id?: string | null;
   }
@@ -403,8 +405,7 @@ export namespace BatchGetStatusResponse {
 
 export interface BatchCreateParams {
   /**
-   * Body param: Job configuration for batch processing. Can be
-   * BatchParseJobRecordCreate or ClassifyJob.
+   * Body param: Job configuration — either a parse or classify config
    */
   job_config: BatchCreateParams.BatchParseJobRecordCreate | JobsAPI.ClassifyJob;
 
@@ -419,9 +420,8 @@ export interface BatchCreateParams {
   project_id?: string | null;
 
   /**
-   * Body param: Maximum number of files to process before calling continue-as-new.
-   * If None, continue-as-new is called after every batch. (only used in directory
-   * mode)
+   * Body param: Maximum files to process per execution cycle in directory mode.
+   * Defaults to page_size.
    */
   continue_as_new_threshold?: number | null;
 
@@ -437,8 +437,7 @@ export interface BatchCreateParams {
   item_ids?: Array<string> | null;
 
   /**
-   * Body param: Number of files to fetch per batch from the directory (only used in
-   * directory mode)
+   * Body param: Number of files to process per batch when using directory mode
    */
   page_size?: number;
 
@@ -813,12 +812,58 @@ export namespace BatchCreateParams {
       version?: string | null;
 
       /**
-       * The outbound webhook configurations
+       * Outbound webhook endpoints to notify on job status changes
        */
-      webhook_configurations?: Array<ExtractionJobsAPI.WebhookConfiguration> | null;
+      webhook_configurations?: Array<Parameters.WebhookConfiguration> | null;
 
       webhook_url?: string | 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.success'
+          | 'classify.error'
+          | 'classify.partial_success'
+          | 'classify.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;
+      }
+    }
   }
 }
 

package/src/resources/beta/batch/job-items.ts

@@ -3,7 +3,6 @@
 import { APIResource } from '../../../core/resource';
 import * as ParsingAPI from '../../parsing';
 import * as JobsAPI from '../../classifier/jobs';
-import * as ExtractionJobsAPI from '../../extraction/jobs';
 import { APIPromise } from '../../../core/api-promise';
 import { PagePromise, PaginatedBatchItems, type PaginatedBatchItemsParams } from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
@@ -13,9 +12,8 @@ export class JobItems extends APIResource {
   /**
    * List items in a batch job with optional status filtering.
    *
-   * Useful for finding failed items, viewing completed items, or debugging issues.
-   * Results are paginated for performance with configurable limit and offset
-   * parameters.
+   * Useful for finding failed items, viewing completed items, or debugging
+   * processing issues.
    */
   list(
     jobID: string,
@@ -30,12 +28,11 @@ export class JobItems extends APIResource {
   }
 
   /**
-   * Get all processing results for a specific item (lineage query).
+   * Get all processing results for a specific item.
    *
-   * Shows complete processing history including what operations have been performed,
-   * with what parameters, and where outputs are stored. Useful for understanding
-   * what processing has already been done to avoid redundant work. Optionally filter
-   * by job type to see only specific processing operations.
+   * Returns the complete processing history for an item including what operations
+   * were performed, parameters used, and where outputs are stored. Optionally filter
+   * by `job_type`.
    */
   getProcessingResults(
     itemID: string,
@@ -144,12 +141,12 @@ export namespace JobItemGetProcessingResultsResponse {
     job_type: 'parse' | 'extract' | 'classify';
 
     /**
-     * S3 location of processing output
+     * Location of the processing output
      */
     output_s3_path: string;
 
     /**
-     * Hash of parameters for deduplication
+     * Content hash of the job configuration for dedup
      */
     parameters_hash: string;
 
@@ -537,12 +534,58 @@ export namespace JobItemGetProcessingResultsResponse {
         version?: string | null;
 
         /**
-         * The outbound webhook configurations
+         * Outbound webhook endpoints to notify on job status changes
          */
-        webhook_configurations?: Array<ExtractionJobsAPI.WebhookConfiguration> | null;
+        webhook_configurations?: Array<Parameters.WebhookConfiguration> | null;
 
         webhook_url?: string | 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.success'
+            | 'classify.error'
+            | 'classify.partial_success'
+            | 'classify.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;
+        }
+      }
     }
   }
 }

package/src/resources/beta/parse-configurations.ts

@@ -13,7 +13,7 @@ export class ParseConfigurations extends APIResource {
    * Create a new parse configuration.
    *
    * Args: config_create: Parse configuration creation data project: Validated
-   * project from dependency user: Current user db: Database session
+   * project from dependency user: Current user
    *
    * Returns: The created parse configuration
    */
@@ -30,8 +30,7 @@ export class ParseConfigurations extends APIResource {
    * Update a parse configuration.
    *
    * Args: config_id: The ID of the parse configuration to update config_update:
-   * Update data project: Validated project from dependency user: Current user db:
-   * Database session
+   * Update data project: Validated project from dependency user: Current user
    *
    * Returns: The updated parse configuration
    */
@@ -51,10 +50,9 @@ export class ParseConfigurations extends APIResource {
   /**
    * List parse configurations for the current project.
    *
-   * Args: project: Validated project from dependency user: Current user db: Database
-   * session page_size: Number of items per page page_token: Token for pagination
-   * name: Filter by configuration name creator: Filter by creator version: Filter by
-   * version
+   * Args: project: Validated project from dependency user: Current user page_size:
+   * Number of items per page page_token: Token for pagination name: Filter by
+   * configuration name creator: Filter by creator version: Filter by version
    *
    * Returns: Paginated response with parse configurations
    */
@@ -72,7 +70,7 @@ export class ParseConfigurations extends APIResource {
    * Delete a parse configuration.
    *
    * Args: config_id: The ID of the parse configuration to delete project: Validated
-   * project from dependency user: Current user db: Database session
+   * project from dependency user: Current user
    */
   delete(
     configID: string,
@@ -91,7 +89,7 @@ export class ParseConfigurations extends APIResource {
    * Get a parse configuration by ID.
    *
    * Args: config_id: The ID of the parse configuration project: Validated project
-   * from dependency user: Current user db: Database session
+   * from dependency user: Current user
    *
    * Returns: The parse configuration
    */

package/src/resources/beta/sheets.ts

@@ -417,11 +417,31 @@ export interface SheetCreateParams {
 }
 
 export interface SheetListParams extends PaginatedCursorParams {
+  /**
+   * Include items created at or after this timestamp (inclusive)
+   */
+  created_at_on_or_after?: string | null;
+
+  /**
+   * Include items created at or before this timestamp (inclusive)
+   */
+  created_at_on_or_before?: string | null;
+
   include_results?: boolean;
 
+  /**
+   * Filter by specific job IDs
+   */
+  job_ids?: Array<string> | null;
+
   organization_id?: string | null;
 
   project_id?: string | null;
+
+  /**
+   * Filter by job status
+   */
+  status?: ParsingAPI.StatusEnum | null;
 }
 
 export interface SheetDeleteJobParams {