@llamaindex/llama-cloud 2.9.0 → 2.10.0

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

@@ -75,6 +75,27 @@ export class Batch extends APIResource {
     });
   }
 
+  /**
+   * Get detailed status of a batch processing job.
+   *
+   * Returns current progress percentage, file counts (total, processed, failed,
+   * skipped), and timestamps.
+   *
+   * @example
+   * ```ts
+   * const response = await client.beta.batch.getStatus(
+   *   'job_id',
+   * );
+   * ```
+   */
+  getStatus(
+    jobID: string,
+    query: BatchGetStatusParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BatchGetStatusResponse> {
+    return this._client.get(path`/api/v1/beta/batch-processing/${jobID}`, { query, ...options });
+  }
+
   /**
    * Cancel a running batch processing job.
    *
@@ -102,27 +123,6 @@ export class Batch extends APIResource {
       ]),
     });
   }
-
-  /**
-   * Get detailed status of a batch processing job.
-   *
-   * Returns current progress percentage, file counts (total, processed, failed,
-   * skipped), and timestamps.
-   *
-   * @example
-   * ```ts
-   * const response = await client.beta.batch.getStatus(
-   *   'job_id',
-   * );
-   * ```
-   */
-  getStatus(
-    jobID: string,
-    query: BatchGetStatusParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<BatchGetStatusResponse> {
-    return this._client.get(path`/api/v1/beta/batch-processing/${jobID}`, { query, ...options });
-  }
 }
 
 export type BatchListResponsesPaginatedBatchItems = PaginatedBatchItems<BatchListResponse>;
@@ -139,7 +139,7 @@ export interface BatchCreateResponse {
   /**
    * Type of processing operation (parse or classify)
    */
-  job_type: 'parse' | 'extract' | 'classify';
+  job_type: 'classify' | 'extract' | 'parse';
 
   /**
    * Project this job belongs to
@@ -149,7 +149,7 @@ export interface BatchCreateResponse {
   /**
    * Current job status
    */
-  status: 'pending' | 'running' | 'dispatched' | 'completed' | 'failed' | 'cancelled';
+  status: 'cancelled' | 'completed' | 'dispatched' | 'failed' | 'pending' | 'running';
 
   /**
    * Total number of items in the job
@@ -226,7 +226,7 @@ export interface BatchListResponse {
   /**
    * Type of processing operation (parse or classify)
    */
-  job_type: 'parse' | 'extract' | 'classify';
+  job_type: 'classify' | 'extract' | 'parse';
 
   /**
    * Project this job belongs to
@@ -236,7 +236,7 @@ export interface BatchListResponse {
   /**
    * Current job status
    */
-  status: 'pending' | 'running' | 'dispatched' | 'completed' | 'failed' | 'cancelled';
+  status: 'cancelled' | 'completed' | 'dispatched' | 'failed' | 'pending' | 'running';
 
   /**
    * Total number of items in the job
@@ -323,7 +323,7 @@ export interface BatchCancelResponse {
   /**
    * New status (should be 'cancelled')
    */
-  status: 'pending' | 'running' | 'dispatched' | 'completed' | 'failed' | 'cancelled';
+  status: 'cancelled' | 'completed' | 'dispatched' | 'failed' | 'pending' | 'running';
 }
 
 /**
@@ -354,7 +354,7 @@ export namespace BatchGetStatusResponse {
     /**
      * Type of processing operation (parse or classify)
      */
-    job_type: 'parse' | 'extract' | 'classify';
+    job_type: 'classify' | 'extract' | 'parse';
 
     /**
      * Project this job belongs to
@@ -364,7 +364,7 @@ export namespace BatchGetStatusResponse {
     /**
      * Current job status
      */
-    status: 'pending' | 'running' | 'dispatched' | 'completed' | 'failed' | 'cancelled';
+    status: 'cancelled' | 'completed' | 'dispatched' | 'failed' | 'pending' | 'running';
 
     /**
      * Total number of items in the job
@@ -650,7 +650,7 @@ export namespace BatchCreateParams {
 
       ignore_document_elements_for_layout_detection?: boolean | null;
 
-      images_to_save?: Array<'screenshot' | 'embedded' | 'layout'> | null;
+      images_to_save?: Array<'embedded' | 'layout' | 'screenshot'> | null;
 
       inline_images_in_markdown?: boolean | null;
 
@@ -764,7 +764,7 @@ export namespace BatchCreateParams {
        * The priority for the request. This field may be ignored or overwritten depending
        * on the organization tier.
        */
-      priority?: 'low' | 'medium' | 'high' | 'critical' | null;
+      priority?: 'critical' | 'high' | 'low' | 'medium' | null;
 
       project_id?: string | null;
 
@@ -856,28 +856,33 @@ export namespace BatchCreateParams {
          * events are delivered.
          */
         webhook_events?: Array<
-          | 'extract.pending'
-          | 'extract.success'
+          | 'classify.cancelled'
+          | 'classify.error'
+          | 'classify.partial_success'
+          | 'classify.pending'
+          | 'classify.running'
+          | 'classify.success'
+          | 'extract.cancelled'
           | 'extract.error'
           | 'extract.partial_success'
-          | 'extract.cancelled'
+          | 'extract.pending'
+          | 'extract.success'
+          | 'parse.cancelled'
+          | 'parse.error'
+          | 'parse.partial_success'
           | '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.cancelled'
           | 'sheets.error'
           | 'sheets.partial_success'
-          | 'sheets.cancelled'
+          | 'sheets.pending'
+          | 'sheets.success'
+          | 'split.cancelled'
+          | 'split.error'
+          | 'split.pending'
+          | 'split.processing'
+          | 'split.success'
           | 'unmapped_event'
         > | null;
 
@@ -891,6 +896,14 @@ export namespace BatchCreateParams {
          */
         webhook_output_format?: string | null;
 
+        /**
+         * Shared signing secret used to sign webhook deliveries. When set, each request
+         * includes an HMAC-SHA256 signature of the request body in the 'LC-Signature'
+         * header (value 'sha256=<hex>'). Recompute the HMAC over the raw request body with
+         * this secret to verify the delivery is authentic.
+         */
+        webhook_signing_secret?: string | null;
+
         /**
          * URL to receive webhook POST notifications
          */
@@ -909,7 +922,7 @@ export interface BatchListParams extends PaginatedBatchItemsParams {
   /**
    * Filter by job type (PARSE, EXTRACT, CLASSIFY)
    */
-  job_type?: 'parse' | 'extract' | 'classify' | null;
+  job_type?: 'classify' | 'extract' | 'parse' | null;
 
   organization_id?: string | null;
 
@@ -918,7 +931,13 @@ export interface BatchListParams extends PaginatedBatchItemsParams {
   /**
    * Filter by job status (PENDING, RUNNING, COMPLETED, FAILED, CANCELLED)
    */
-  status?: 'pending' | 'running' | 'dispatched' | 'completed' | 'failed' | 'cancelled' | null;
+  status?: 'cancelled' | 'completed' | 'dispatched' | 'failed' | 'pending' | 'running' | null;
+}
+
+export interface BatchGetStatusParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
 }
 
 export interface BatchCancelParams {
@@ -943,12 +962,6 @@ export interface BatchCancelParams {
   'temporal-namespace'?: string;
 }
 
-export interface BatchGetStatusParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
-}
-
 Batch.JobItems = JobItems;
 
 export declare namespace Batch {
@@ -960,8 +973,8 @@ export declare namespace Batch {
     type BatchListResponsesPaginatedBatchItems as BatchListResponsesPaginatedBatchItems,
     type BatchCreateParams as BatchCreateParams,
     type BatchListParams as BatchListParams,
-    type BatchCancelParams as BatchCancelParams,
     type BatchGetStatusParams as BatchGetStatusParams,
+    type BatchCancelParams as BatchCancelParams,
   };
 
   export {

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

@@ -8,8 +8,8 @@ export {
   type BatchGetStatusResponse,
   type BatchCreateParams,
   type BatchListParams,
-  type BatchCancelParams,
   type BatchGetStatusParams,
+  type BatchCancelParams,
   type BatchListResponsesPaginatedBatchItems,
 } from './batch';
 export {

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

@@ -83,7 +83,7 @@ export interface JobItemListResponse {
   /**
    * Processing status of this item
    */
-  status: 'pending' | 'processing' | 'completed' | 'failed' | 'skipped' | 'cancelled';
+  status: 'cancelled' | 'completed' | 'failed' | 'pending' | 'processing' | 'skipped';
 
   /**
    * When processing completed for this item
@@ -156,7 +156,7 @@ export namespace JobItemGetProcessingResultsResponse {
     /**
      * Type of processing performed
      */
-    job_type: 'parse' | 'extract' | 'classify';
+    job_type: 'classify' | 'extract' | 'parse';
 
     /**
      * Location of the processing output
@@ -363,7 +363,7 @@ export namespace JobItemGetProcessingResultsResponse {
 
         ignore_document_elements_for_layout_detection?: boolean | null;
 
-        images_to_save?: Array<'screenshot' | 'embedded' | 'layout'> | null;
+        images_to_save?: Array<'embedded' | 'layout' | 'screenshot'> | null;
 
         inline_images_in_markdown?: boolean | null;
 
@@ -477,7 +477,7 @@ export namespace JobItemGetProcessingResultsResponse {
          * The priority for the request. This field may be ignored or overwritten depending
          * on the organization tier.
          */
-        priority?: 'low' | 'medium' | 'high' | 'critical' | null;
+        priority?: 'critical' | 'high' | 'low' | 'medium' | null;
 
         project_id?: string | null;
 
@@ -569,28 +569,33 @@ export namespace JobItemGetProcessingResultsResponse {
            * events are delivered.
            */
           webhook_events?: Array<
-            | 'extract.pending'
-            | 'extract.success'
+            | 'classify.cancelled'
+            | 'classify.error'
+            | 'classify.partial_success'
+            | 'classify.pending'
+            | 'classify.running'
+            | 'classify.success'
+            | 'extract.cancelled'
             | 'extract.error'
             | 'extract.partial_success'
-            | 'extract.cancelled'
+            | 'extract.pending'
+            | 'extract.success'
+            | 'parse.cancelled'
+            | 'parse.error'
+            | 'parse.partial_success'
             | '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.cancelled'
             | 'sheets.error'
             | 'sheets.partial_success'
-            | 'sheets.cancelled'
+            | 'sheets.pending'
+            | 'sheets.success'
+            | 'split.cancelled'
+            | 'split.error'
+            | 'split.pending'
+            | 'split.processing'
+            | 'split.success'
             | 'unmapped_event'
           > | null;
 
@@ -604,6 +609,14 @@ export namespace JobItemGetProcessingResultsResponse {
            */
           webhook_output_format?: string | null;
 
+          /**
+           * Shared signing secret used to sign webhook deliveries. When set, each request
+           * includes an HMAC-SHA256 signature of the request body in the 'LC-Signature'
+           * header (value 'sha256=<hex>'). Recompute the HMAC over the raw request body with
+           * this secret to verify the delivery is authentic.
+           */
+          webhook_signing_secret?: string | null;
+
           /**
            * URL to receive webhook POST notifications
            */
@@ -622,14 +635,14 @@ export interface JobItemListParams extends PaginatedBatchItemsParams {
   /**
    * Filter items by status
    */
-  status?: 'pending' | 'processing' | 'completed' | 'failed' | 'skipped' | 'cancelled' | null;
+  status?: 'cancelled' | 'completed' | 'failed' | 'pending' | 'processing' | 'skipped' | null;
 }
 
 export interface JobItemGetProcessingResultsParams {
   /**
    * Filter results by job type
    */
-  job_type?: 'parse' | 'extract' | 'classify' | null;
+  job_type?: 'classify' | 'extract' | 'parse' | null;
 
   organization_id?: string | null;
 

package/src/resources/beta/beta.ts

@@ -144,11 +144,11 @@ export declare namespace Beta {
     type IndexGetResponse as IndexGetResponse,
     type IndexSyncResponse as IndexSyncResponse,
     type IndexListResponsesPaginatedCursor as IndexListResponsesPaginatedCursor,
-    type IndexCreateParams as IndexCreateParams,
-    type IndexListParams as IndexListParams,
-    type IndexDeleteParams as IndexDeleteParams,
     type IndexGetParams as IndexGetParams,
+    type IndexDeleteParams as IndexDeleteParams,
+    type IndexCreateParams as IndexCreateParams,
     type IndexSyncParams as IndexSyncParams,
+    type IndexListParams as IndexListParams,
   };
 
   export {
@@ -173,9 +173,9 @@ export declare namespace Beta {
     type ChatGetSummaryResponse as ChatGetSummaryResponse,
     type ChatStreamResponse as ChatStreamResponse,
     type ChatListResponsesPaginatedCursor as ChatListResponsesPaginatedCursor,
+    type ChatListParams as ChatListParams,
     type ChatCreateParams as ChatCreateParams,
     type ChatRetrieveParams as ChatRetrieveParams,
-    type ChatListParams as ChatListParams,
     type ChatDeleteParams as ChatDeleteParams,
     type ChatGetSummaryParams as ChatGetSummaryParams,
     type ChatStreamParams as ChatStreamParams,
@@ -186,15 +186,15 @@ export declare namespace Beta {
     type AgentDataDeleteResponse as AgentDataDeleteResponse,
     type AgentDataAggregateResponse as AgentDataAggregateResponse,
     type AgentDataDeleteByQueryResponse as AgentDataDeleteByQueryResponse,
-    type AgentDataAggregateResponsesPaginatedCursorPost as AgentDataAggregateResponsesPaginatedCursorPost,
     type AgentDataPaginatedCursorPost as AgentDataPaginatedCursorPost,
-    type AgentDataCreateParams as AgentDataCreateParams,
+    type AgentDataAggregateResponsesPaginatedCursorPost as AgentDataAggregateResponsesPaginatedCursorPost,
+    type AgentDataGetParams as AgentDataGetParams,
     type AgentDataUpdateParams as AgentDataUpdateParams,
     type AgentDataDeleteParams as AgentDataDeleteParams,
+    type AgentDataCreateParams as AgentDataCreateParams,
+    type AgentDataSearchParams as AgentDataSearchParams,
     type AgentDataAggregateParams as AgentDataAggregateParams,
     type AgentDataDeleteByQueryParams as AgentDataDeleteByQueryParams,
-    type AgentDataGetParams as AgentDataGetParams,
-    type AgentDataSearchParams as AgentDataSearchParams,
   };
 
   export {
@@ -205,9 +205,9 @@ export declare namespace Beta {
     type SheetsJobsPaginatedCursor as SheetsJobsPaginatedCursor,
     type SheetCreateParams as SheetCreateParams,
     type SheetListParams as SheetListParams,
-    type SheetDeleteJobParams as SheetDeleteJobParams,
     type SheetGetParams as SheetGetParams,
     type SheetGetResultTableParams as SheetGetResultTableParams,
+    type SheetDeleteJobParams as SheetDeleteJobParams,
   };
 
   export {
@@ -218,10 +218,10 @@ export declare namespace Beta {
     type DirectoryGetResponse as DirectoryGetResponse,
     type DirectoryListResponsesPaginatedCursor as DirectoryListResponsesPaginatedCursor,
     type DirectoryCreateParams as DirectoryCreateParams,
-    type DirectoryUpdateParams as DirectoryUpdateParams,
     type DirectoryListParams as DirectoryListParams,
-    type DirectoryDeleteParams as DirectoryDeleteParams,
     type DirectoryGetParams as DirectoryGetParams,
+    type DirectoryUpdateParams as DirectoryUpdateParams,
+    type DirectoryDeleteParams as DirectoryDeleteParams,
   };
 
   export {
@@ -233,8 +233,8 @@ export declare namespace Beta {
     type BatchListResponsesPaginatedBatchItems as BatchListResponsesPaginatedBatchItems,
     type BatchCreateParams as BatchCreateParams,
     type BatchListParams as BatchListParams,
-    type BatchCancelParams as BatchCancelParams,
     type BatchGetStatusParams as BatchGetStatusParams,
+    type BatchCancelParams as BatchCancelParams,
   };
 
   export {

package/src/resources/beta/chat.ts

@@ -8,6 +8,24 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Chat extends APIResource {
+  /**
+   * List all chat sessions for the current project.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const chatListResponse of client.beta.chat.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: ChatListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ChatListResponsesPaginatedCursor, ChatListResponse> {
+    return this._client.getAPIList('/api/v1/chat', PaginatedCursor<ChatListResponse>, { query, ...options });
+  }
+
   /**
    * Create a chat session, optionally bound to indexes (locked after the first
    * message).
@@ -41,24 +59,6 @@ export class Chat extends APIResource {
     return this._client.get(path`/api/v1/chat/${sessionID}`, { query, ...options });
   }
 
-  /**
-   * List all chat sessions for the current project.
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const chatListResponse of client.beta.chat.list()) {
-   *   // ...
-   * }
-   * ```
-   */
-  list(
-    query: ChatListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<ChatListResponsesPaginatedCursor, ChatListResponse> {
-    return this._client.getAPIList('/api/v1/chat', PaginatedCursor<ChatListResponse>, { query, ...options });
-  }
-
   /**
    * Delete a session.
    *
@@ -185,13 +185,13 @@ export interface ChatRetrieveResponse {
    * Ordered list of events that make up the conversation history.
    */
   events: Array<
-    | ChatRetrieveResponse.ThinkingDeltaEvent
+    | ChatRetrieveResponse.StopEvent
     | ChatRetrieveResponse.TextDeltaEvent
-    | ChatRetrieveResponse.ThinkingEvent
     | ChatRetrieveResponse.TextEvent
+    | ChatRetrieveResponse.ThinkingDeltaEvent
+    | ChatRetrieveResponse.ThinkingEvent
     | ChatRetrieveResponse.ToolCallEvent
     | ChatRetrieveResponse.ToolResultEvent
-    | ChatRetrieveResponse.StopEvent
     | ChatRetrieveResponse.UserInputEvent
   >;
 
@@ -223,10 +223,26 @@ export interface ChatRetrieveResponse {
 }
 
 export namespace ChatRetrieveResponse {
-  export interface ThinkingDeltaEvent {
-    content: string;
+  export interface StopEvent {
+    error: string | null;
 
-    type?: 'thinking_delta';
+    is_error: boolean;
+
+    usage: StopEvent.Usage;
+
+    type?: 'stop';
+  }
+
+  export namespace StopEvent {
+    export interface Usage {
+      duration_ms?: number;
+
+      total_input_tokens?: number | null;
+
+      total_output_tokens?: number | null;
+
+      turns?: number;
+    }
   }
 
   export interface TextDeltaEvent {
@@ -235,16 +251,22 @@ export namespace ChatRetrieveResponse {
     type?: 'text_delta';
   }
 
-  export interface ThinkingEvent {
+  export interface TextEvent {
     content: string;
 
-    type?: 'thinking';
+    type?: 'text';
   }
 
-  export interface TextEvent {
+  export interface ThinkingDeltaEvent {
     content: string;
 
-    type?: 'text';
+    type?: 'thinking_delta';
+  }
+
+  export interface ThinkingEvent {
+    content: string;
+
+    type?: 'thinking';
   }
 
   export interface ToolCallEvent {
@@ -283,28 +305,6 @@ export namespace ChatRetrieveResponse {
     }
   }
 
-  export interface StopEvent {
-    error: string | null;
-
-    is_error: boolean;
-
-    usage: StopEvent.Usage;
-
-    type?: 'stop';
-  }
-
-  export namespace StopEvent {
-    export interface Usage {
-      duration_ms?: number;
-
-      total_input_tokens?: number | null;
-
-      total_output_tokens?: number | null;
-
-      turns?: number;
-    }
-  }
-
   export interface UserInputEvent {
     content: string;
 
@@ -440,6 +440,12 @@ export namespace ChatGetSummaryResponse {
 
 export type ChatStreamResponse = unknown;
 
+export interface ChatListParams extends PaginatedCursorParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
 export interface ChatCreateParams {
   /**
    * Query param
@@ -465,12 +471,6 @@ export interface ChatRetrieveParams {
   project_id?: string | null;
 }
 
-export interface ChatListParams extends PaginatedCursorParams {
-  organization_id?: string | null;
-
-  project_id?: string | null;
-}
-
 export interface ChatDeleteParams {
   organization_id?: string | null;
 
@@ -513,9 +513,9 @@ export declare namespace Chat {
     type ChatGetSummaryResponse as ChatGetSummaryResponse,
     type ChatStreamResponse as ChatStreamResponse,
     type ChatListResponsesPaginatedCursor as ChatListResponsesPaginatedCursor,
+    type ChatListParams as ChatListParams,
     type ChatCreateParams as ChatCreateParams,
     type ChatRetrieveParams as ChatRetrieveParams,
-    type ChatListParams as ChatListParams,
     type ChatDeleteParams as ChatDeleteParams,
     type ChatGetSummaryParams as ChatGetSummaryParams,
     type ChatStreamParams as ChatStreamParams,