@llamaindex/llama-cloud 1.7.0 → 1.8.0

package/src/resources/classify.ts

@@ -0,0 +1,433 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { PagePromise, PaginatedCursor, type PaginatedCursorParams } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class Classify extends APIResource {
+  /**
+   * Create a classify job.
+   */
+  create(params: ClassifyCreateParams, options?: RequestOptions): APIPromise<ClassifyCreateResponse> {
+    const { organization_id, project_id, ...body } = params;
+    return this._client.post('/api/v2/classify', {
+      query: { organization_id, project_id },
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * List classify jobs.
+   */
+  list(
+    query: ClassifyListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ClassifyListResponsesPaginatedCursor, ClassifyListResponse> {
+    return this._client.getAPIList('/api/v2/classify', PaginatedCursor<ClassifyListResponse>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Retrieve classify job by ID.
+   */
+  get(
+    jobID: string,
+    query: ClassifyGetParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<ClassifyGetResponse> {
+    return this._client.get(path`/api/v2/classify/${jobID}`, { query, ...options });
+  }
+}
+
+export type ClassifyListResponsesPaginatedCursor = PaginatedCursor<ClassifyListResponse>;
+
+/**
+ * Configuration for classification.
+ */
+export interface ClassifyConfiguration {
+  /**
+   * Classification rules to apply (at least one required)
+   */
+  rules: Array<ClassifyConfiguration.Rule>;
+
+  /**
+   * Classification execution mode
+   */
+  mode?: 'FAST';
+}
+
+export namespace ClassifyConfiguration {
+  /**
+   * A rule for classifying documents.
+   */
+  export interface Rule {
+    /**
+     * Natural language description of what to classify
+     */
+    description: string;
+
+    /**
+     * Document type to assign when rule matches
+     */
+    type: string;
+  }
+}
+
+/**
+ * Request to create a classify job.
+ */
+export interface ClassifyCreateRequest {
+  /**
+   * Configuration for classification.
+   */
+  configuration?: ClassifyConfiguration | null;
+
+  /**
+   * Product configuration ID for reusable presets
+   */
+  configuration_id?: string | null;
+
+  /**
+   * File ID to classify
+   */
+  file_id?: string | null;
+
+  /**
+   * Parse job ID to classify
+   */
+  parse_job_id?: string | null;
+
+  /**
+   * Idempotency key scoped to the project
+   */
+  transaction_id?: string | null;
+}
+
+/**
+ * Result of classifying a document.
+ */
+export interface ClassifyResult {
+  /**
+   * Confidence score (0.0-1.0)
+   */
+  confidence: number;
+
+  /**
+   * Explanation of classification decision
+   */
+  reasoning: string;
+
+  /**
+   * Document type that matches, or None
+   */
+  type: string | null;
+}
+
+/**
+ * Response for a classify job.
+ */
+export interface ClassifyCreateResponse {
+  /**
+   * Unique identifier
+   */
+  id: string;
+
+  /**
+   * Classification configuration
+   */
+  configuration: ClassifyConfiguration;
+
+  /**
+   * Type of document input
+   */
+  document_input_type: 'url' | 'file_id' | 'parse_job_id';
+
+  /**
+   * Document identifier
+   */
+  document_input_value: string;
+
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Job status
+   */
+  status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED';
+
+  /**
+   * User ID
+   */
+  user_id: string;
+
+  /**
+   * Product configuration ID
+   */
+  configuration_id?: string | null;
+
+  /**
+   * Creation datetime
+   */
+  created_at?: string | null;
+
+  /**
+   * Error message if job failed
+   */
+  error_message?: string | null;
+
+  /**
+   * Associated parse job ID
+   */
+  parse_job_id?: string | null;
+
+  /**
+   * Result of classifying a document.
+   */
+  result?: ClassifyResult | null;
+
+  /**
+   * Idempotency key
+   */
+  transaction_id?: string | null;
+
+  /**
+   * Update datetime
+   */
+  updated_at?: string | null;
+}
+
+/**
+ * Response for a classify job.
+ */
+export interface ClassifyListResponse {
+  /**
+   * Unique identifier
+   */
+  id: string;
+
+  /**
+   * Classification configuration
+   */
+  configuration: ClassifyConfiguration;
+
+  /**
+   * Type of document input
+   */
+  document_input_type: 'url' | 'file_id' | 'parse_job_id';
+
+  /**
+   * Document identifier
+   */
+  document_input_value: string;
+
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Job status
+   */
+  status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED';
+
+  /**
+   * User ID
+   */
+  user_id: string;
+
+  /**
+   * Product configuration ID
+   */
+  configuration_id?: string | null;
+
+  /**
+   * Creation datetime
+   */
+  created_at?: string | null;
+
+  /**
+   * Error message if job failed
+   */
+  error_message?: string | null;
+
+  /**
+   * Associated parse job ID
+   */
+  parse_job_id?: string | null;
+
+  /**
+   * Result of classifying a document.
+   */
+  result?: ClassifyResult | null;
+
+  /**
+   * Idempotency key
+   */
+  transaction_id?: string | null;
+
+  /**
+   * Update datetime
+   */
+  updated_at?: string | null;
+}
+
+/**
+ * Response for a classify job.
+ */
+export interface ClassifyGetResponse {
+  /**
+   * Unique identifier
+   */
+  id: string;
+
+  /**
+   * Classification configuration
+   */
+  configuration: ClassifyConfiguration;
+
+  /**
+   * Type of document input
+   */
+  document_input_type: 'url' | 'file_id' | 'parse_job_id';
+
+  /**
+   * Document identifier
+   */
+  document_input_value: string;
+
+  /**
+   * Project ID
+   */
+  project_id: string;
+
+  /**
+   * Job status
+   */
+  status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED';
+
+  /**
+   * User ID
+   */
+  user_id: string;
+
+  /**
+   * Product configuration ID
+   */
+  configuration_id?: string | null;
+
+  /**
+   * Creation datetime
+   */
+  created_at?: string | null;
+
+  /**
+   * Error message if job failed
+   */
+  error_message?: string | null;
+
+  /**
+   * Associated parse job ID
+   */
+  parse_job_id?: string | null;
+
+  /**
+   * Result of classifying a document.
+   */
+  result?: ClassifyResult | null;
+
+  /**
+   * Idempotency key
+   */
+  transaction_id?: string | null;
+
+  /**
+   * Update datetime
+   */
+  updated_at?: string | null;
+}
+
+export interface ClassifyCreateParams {
+  /**
+   * Query param
+   */
+  organization_id?: string | null;
+
+  /**
+   * Query param
+   */
+  project_id?: string | null;
+
+  /**
+   * Body param: Configuration for classification.
+   */
+  configuration?: ClassifyConfiguration | null;
+
+  /**
+   * Body param: Product configuration ID for reusable presets
+   */
+  configuration_id?: string | null;
+
+  /**
+   * Body param: File ID to classify
+   */
+  file_id?: string | null;
+
+  /**
+   * Body param: Parse job ID to classify
+   */
+  parse_job_id?: string | null;
+
+  /**
+   * Body param: Idempotency key scoped to the project
+   */
+  transaction_id?: string | null;
+}
+
+export interface ClassifyListParams extends PaginatedCursorParams {
+  /**
+   * Filter by configuration ID
+   */
+  configuration_id?: string | null;
+
+  /**
+   * Filter by specific job IDs
+   */
+  job_ids?: Array<string> | null;
+
+  organization_id?: string | null;
+
+  project_id?: string | null;
+
+  /**
+   * Filter by job status
+   */
+  status?: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | null;
+}
+
+export interface ClassifyGetParams {
+  organization_id?: string | null;
+
+  project_id?: string | null;
+}
+
+export declare namespace Classify {
+  export {
+    type ClassifyConfiguration as ClassifyConfiguration,
+    type ClassifyCreateRequest as ClassifyCreateRequest,
+    type ClassifyResult as ClassifyResult,
+    type ClassifyCreateResponse as ClassifyCreateResponse,
+    type ClassifyListResponse as ClassifyListResponse,
+    type ClassifyGetResponse as ClassifyGetResponse,
+    type ClassifyListResponsesPaginatedCursor as ClassifyListResponsesPaginatedCursor,
+    type ClassifyCreateParams as ClassifyCreateParams,
+    type ClassifyListParams as ClassifyListParams,
+    type ClassifyGetParams as ClassifyGetParams,
+  };
+}

package/src/resources/index.ts

@@ -3,6 +3,19 @@
 export * from './shared';
 export { Beta } from './beta/beta';
 export { Classifier } from './classifier/classifier';
+export {
+  Classify,
+  type ClassifyConfiguration,
+  type ClassifyCreateRequest,
+  type ClassifyResult,
+  type ClassifyCreateResponse,
+  type ClassifyListResponse,
+  type ClassifyGetResponse,
+  type ClassifyCreateParams,
+  type ClassifyListParams,
+  type ClassifyGetParams,
+  type ClassifyListResponsesPaginatedCursor,
+} from './classify';
 export {
   DataSinks,
   type DataSink,

package/src/resources/parsing.ts

@@ -1016,6 +1016,17 @@ export namespace ParsingGetResponse {
        */
       index: number;
 
+      /**
+       * Bounding box for an image on its page.
+       */
+      bbox?: Image.Bbox | null;
+
+      /**
+       * Image category: 'screenshot' (full page), 'embedded' (images in document), or
+       * 'layout' (cropped from layout detection)
+       */
+      category?: 'screenshot' | 'embedded' | 'layout' | null;
+
       /**
        * MIME type of the image
        */
@@ -1031,6 +1042,33 @@ export namespace ParsingGetResponse {
        */
       size_bytes?: number | null;
     }
+
+    export namespace Image {
+      /**
+       * Bounding box for an image on its page.
+       */
+      export interface Bbox {
+        /**
+         * Height of the bounding box
+         */
+        h: number;
+
+        /**
+         * Width of the bounding box
+         */
+        w: number;
+
+        /**
+         * X coordinate of the bounding box
+         */
+        x: number;
+
+        /**
+         * Y coordinate of the bounding box
+         */
+        y: number;
+      }
+    }
   }
 
   /**
@@ -1283,6 +1321,9 @@ export interface ParsingCreateParams {
     | '2026-02-20'
     | '2026-02-24'
     | '2026-02-26'
+    | '2026-03-02'
+    | '2026-03-03'
+    | '2026-03-04'
     | 'latest'
     | (string & {});
 
@@ -2002,6 +2043,9 @@ export namespace ParsingCreateParams {
           | '2026-02-20'
           | '2026-02-24'
           | '2026-02-26'
+          | '2026-03-02'
+          | '2026-03-03'
+          | '2026-03-04'
           | 'latest'
           | (string & {})
           | null;

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.7.0'; // x-release-please-version
+export const VERSION = '1.8.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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