@llamaindex/llama-cloud 2.2.0 → 2.4.0

package/resources/classify.js

@@ -5,6 +5,7 @@ exports.Classify = void 0;
 const resource_1 = require("../core/resource.js");
 const pagination_1 = require("../core/pagination.js");
 const path_1 = require("../internal/utils/path.js");
+const polling_1 = require("../core/polling.js");
 class Classify extends resource_1.APIResource {
     /**
      * Create a classify job.
@@ -19,6 +20,11 @@ class Classify extends resource_1.APIResource {
      *
      * The job runs asynchronously. Poll `GET /classify/{job_id}` to check status and
      * retrieve results.
+     *
+     * @example
+     * ```ts
+     * const classify = await client.classify.create();
+     * ```
      */
     create(params, options) {
         const { organization_id, project_id, ...body } = params;
@@ -33,6 +39,14 @@ class Classify extends resource_1.APIResource {
      *
      * Filter by `status`, `configuration_id`, specific `job_ids`, or creation date
      * range.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const classifyListResponse of client.classify.list()) {
+     *   // ...
+     * }
+     * ```
      */
     list(query = {}, options) {
         return this._client.getAPIList('/api/v2/classify', (pagination_1.PaginatedCursor), {
@@ -45,10 +59,109 @@ class Classify extends resource_1.APIResource {
      *
      * Returns the job status, configuration, and classify result when complete. The
      * result includes the matched document type, confidence score, and reasoning.
+     *
+     * @example
+     * ```ts
+     * const classify = await client.classify.get('job_id');
+     * ```
      */
     get(jobID, query = {}, options) {
         return this._client.get((0, path_1.path) `/api/v2/classify/${jobID}`, { query, ...options });
     }
+    /**
+     * Wait for a classify job to complete by polling until it reaches a terminal state.
+     *
+     * @param jobID - The ID of the classify job to wait for
+     * @param query - Optional query parameters (organization_id, project_id)
+     * @param options - Polling configuration and request options
+     * @returns The completed classify job
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails
+     *
+     * @example
+     * ```typescript
+     * const job = await client.classify.create({
+     *   file_input: 'dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee',
+     *   configuration_id: 'cfg-...',
+     * });
+     *
+     * const completed = await client.classify.waitForCompletion(job.id, undefined, { verbose: true });
+     * console.log(completed.result);
+     * ```
+     */
+    async waitForCompletion(jobID, query, options) {
+        const { pollingInterval, maxInterval, timeout, backoff, verbose, ...requestOptions } = options || {};
+        const getStatus = async () => {
+            return await this.get(jobID, query, requestOptions);
+        };
+        const isComplete = (job) => {
+            return job.status === 'COMPLETED';
+        };
+        const isError = (job) => {
+            return job.status === 'FAILED';
+        };
+        const getErrorMessage = (job) => {
+            const errorParts = [`Job ${jobID} failed with status: ${job.status}`];
+            if (job.error_message) {
+                errorParts.push(`Error: ${job.error_message}`);
+            }
+            return errorParts.join(' | ');
+        };
+        return await (0, polling_1.pollUntilComplete)(getStatus, isComplete, isError, getErrorMessage, {
+            pollingInterval,
+            maxInterval,
+            timeout: timeout || polling_1.DEFAULT_TIMEOUT,
+            backoff,
+            verbose,
+        });
+    }
+    /**
+     * Create a classify job, wait for it to complete, and return the result.
+     *
+     * This is a convenience method that combines create() and waitForCompletion()
+     * into a single call for the most common end-to-end workflow.
+     *
+     * @param params - Classify job creation parameters
+     * @param options - Polling configuration and request options
+     * @returns The completed classify job with result populated
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails
+     *
+     * @example
+     * ```typescript
+     * import { LlamaCloud } from 'llama-cloud';
+     *
+     * const client = new LlamaCloud({ apiKey: '...' });
+     *
+     * const result = await client.classify.run({
+     *   file_input: 'dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee',
+     *   configuration: {
+     *     rules: [{ type: 'invoice', description: 'contains invoice number' }],
+     *   },
+     * }, { verbose: true });
+     *
+     * console.log(result.result);
+     * ```
+     */
+    async run(params, options) {
+        const { pollingInterval, maxInterval, timeout, backoff, verbose, ...requestOptions } = options || {};
+        const job = await this.create(params, requestOptions);
+        const getQuery = {};
+        if (params.organization_id !== undefined) {
+            getQuery.organization_id = params.organization_id;
+        }
+        if (params.project_id !== undefined) {
+            getQuery.project_id = params.project_id;
+        }
+        return await this.waitForCompletion(job.id, getQuery, {
+            pollingInterval,
+            maxInterval,
+            timeout: timeout || polling_1.DEFAULT_TIMEOUT,
+            backoff,
+            verbose,
+            ...requestOptions,
+        });
+    }
 }
 exports.Classify = Classify;
 //# sourceMappingURL=classify.js.map

package/resources/classify.js.map

@@ -1 +1 @@
-{"version":3,"file":"classify.js","sourceRoot":"","sources":["../src/resources/classify.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAA8F;AAE9F,oDAA8C;AAE9C,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAA4B,EAAE,OAAwB;QAC3D,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAC3C,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;YACtC,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,4BAAqC,CAAA,EAAE;YACxF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,GAAG,CACD,KAAa,EACb,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;CACF;AArDD,4BAqDC"}
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../src/resources/classify.ts"],"names":[],"mappings":"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"}

package/resources/classify.mjs

@@ -2,6 +2,7 @@
 import { APIResource } from "../core/resource.mjs";
 import { PaginatedCursor } from "../core/pagination.mjs";
 import { path } from "../internal/utils/path.mjs";
+import { pollUntilComplete, DEFAULT_TIMEOUT } from "../core/polling.mjs";
 export class Classify extends APIResource {
     /**
      * Create a classify job.
@@ -16,6 +17,11 @@ export class Classify extends APIResource {
      *
      * The job runs asynchronously. Poll `GET /classify/{job_id}` to check status and
      * retrieve results.
+     *
+     * @example
+     * ```ts
+     * const classify = await client.classify.create();
+     * ```
      */
     create(params, options) {
         const { organization_id, project_id, ...body } = params;
@@ -30,6 +36,14 @@ export class Classify extends APIResource {
      *
      * Filter by `status`, `configuration_id`, specific `job_ids`, or creation date
      * range.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const classifyListResponse of client.classify.list()) {
+     *   // ...
+     * }
+     * ```
      */
     list(query = {}, options) {
         return this._client.getAPIList('/api/v2/classify', (PaginatedCursor), {
@@ -42,9 +56,108 @@ export class Classify extends APIResource {
      *
      * Returns the job status, configuration, and classify result when complete. The
      * result includes the matched document type, confidence score, and reasoning.
+     *
+     * @example
+     * ```ts
+     * const classify = await client.classify.get('job_id');
+     * ```
      */
     get(jobID, query = {}, options) {
         return this._client.get(path `/api/v2/classify/${jobID}`, { query, ...options });
     }
+    /**
+     * Wait for a classify job to complete by polling until it reaches a terminal state.
+     *
+     * @param jobID - The ID of the classify job to wait for
+     * @param query - Optional query parameters (organization_id, project_id)
+     * @param options - Polling configuration and request options
+     * @returns The completed classify job
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails
+     *
+     * @example
+     * ```typescript
+     * const job = await client.classify.create({
+     *   file_input: 'dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee',
+     *   configuration_id: 'cfg-...',
+     * });
+     *
+     * const completed = await client.classify.waitForCompletion(job.id, undefined, { verbose: true });
+     * console.log(completed.result);
+     * ```
+     */
+    async waitForCompletion(jobID, query, options) {
+        const { pollingInterval, maxInterval, timeout, backoff, verbose, ...requestOptions } = options || {};
+        const getStatus = async () => {
+            return await this.get(jobID, query, requestOptions);
+        };
+        const isComplete = (job) => {
+            return job.status === 'COMPLETED';
+        };
+        const isError = (job) => {
+            return job.status === 'FAILED';
+        };
+        const getErrorMessage = (job) => {
+            const errorParts = [`Job ${jobID} failed with status: ${job.status}`];
+            if (job.error_message) {
+                errorParts.push(`Error: ${job.error_message}`);
+            }
+            return errorParts.join(' | ');
+        };
+        return await pollUntilComplete(getStatus, isComplete, isError, getErrorMessage, {
+            pollingInterval,
+            maxInterval,
+            timeout: timeout || DEFAULT_TIMEOUT,
+            backoff,
+            verbose,
+        });
+    }
+    /**
+     * Create a classify job, wait for it to complete, and return the result.
+     *
+     * This is a convenience method that combines create() and waitForCompletion()
+     * into a single call for the most common end-to-end workflow.
+     *
+     * @param params - Classify job creation parameters
+     * @param options - Polling configuration and request options
+     * @returns The completed classify job with result populated
+     * @throws {PollingTimeoutError} If the job doesn't complete within the timeout period
+     * @throws {PollingError} If the job fails
+     *
+     * @example
+     * ```typescript
+     * import { LlamaCloud } from 'llama-cloud';
+     *
+     * const client = new LlamaCloud({ apiKey: '...' });
+     *
+     * const result = await client.classify.run({
+     *   file_input: 'dfl-aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee',
+     *   configuration: {
+     *     rules: [{ type: 'invoice', description: 'contains invoice number' }],
+     *   },
+     * }, { verbose: true });
+     *
+     * console.log(result.result);
+     * ```
+     */
+    async run(params, options) {
+        const { pollingInterval, maxInterval, timeout, backoff, verbose, ...requestOptions } = options || {};
+        const job = await this.create(params, requestOptions);
+        const getQuery = {};
+        if (params.organization_id !== undefined) {
+            getQuery.organization_id = params.organization_id;
+        }
+        if (params.project_id !== undefined) {
+            getQuery.project_id = params.project_id;
+        }
+        return await this.waitForCompletion(job.id, getQuery, {
+            pollingInterval,
+            maxInterval,
+            timeout: timeout || DEFAULT_TIMEOUT,
+            backoff,
+            verbose,
+            ...requestOptions,
+        });
+    }
 }
 //# sourceMappingURL=classify.mjs.map

package/resources/classify.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"classify.mjs","sourceRoot":"","sources":["../src/resources/classify.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAe,eAAe,EAA8B;OAE5D,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAA4B,EAAE,OAAwB;QAC3D,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE;YAC3C,KAAK,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;YACtC,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,eAAqC,CAAA,EAAE;YACxF,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,GAAG,CACD,KAAa,EACb,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;CACF"}
+{"version":3,"file":"classify.mjs","sourceRoot":"","sources":["../src/resources/classify.ts"],"names":[],"mappings":"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"}

package/resources/configurations.d.mts

@@ -95,7 +95,58 @@ export interface ConfigurationCreate {
     /**
      * Product-specific configuration parameters.
      */
-    parameters: SplitV1Parameters | ExtractV2Parameters | ClassifyV2Parameters | ParseV2Parameters | UntypedParameters;
+    parameters: SplitV1Parameters | ExtractV2Parameters | ClassifyV2Parameters | ParseV2Parameters | ConfigurationCreate.SpreadsheetV1Parameters | UntypedParameters;
+}
+export declare namespace ConfigurationCreate {
+    /**
+     * Typed parameters for a _spreadsheet v1_ product configuration.
+     */
+    interface SpreadsheetV1Parameters {
+        /**
+         * Product type.
+         */
+        product_type: 'spreadsheet_v1';
+        /**
+         * A1 notation of the range to extract a single region from. If None, the entire
+         * sheet is used.
+         */
+        extraction_range?: string | null;
+        /**
+         * Return a flattened dataframe when a detected table is recognized as
+         * hierarchical.
+         */
+        flatten_hierarchical_tables?: boolean;
+        /**
+         * Whether to generate additional metadata (title, description) for each extracted
+         * region.
+         */
+        generate_additional_metadata?: boolean;
+        /**
+         * Whether to include hidden cells when extracting regions from the spreadsheet.
+         */
+        include_hidden_cells?: boolean;
+        /**
+         * The names of the sheets to extract regions from. If empty, all sheets will be
+         * processed.
+         */
+        sheet_names?: Array<string> | null;
+        /**
+         * Optional specialization mode for domain-specific extraction. Supported values:
+         * 'financial-standard', 'financial-enhanced', 'financial-precise'. Default None
+         * uses the general-purpose pipeline.
+         */
+        specialization?: string | null;
+        /**
+         * Influences how likely similar-looking regions are merged into a single table.
+         * Useful for spreadsheets that either have sparse tables (strong merging) or many
+         * distinct tables close together (weak merging).
+         */
+        table_merge_sensitivity?: 'strong' | 'weak';
+        /**
+         * Enables experimental processing. Accuracy may be impacted.
+         */
+        use_experimental_processing?: boolean;
+    }
 }
 /**
  * Response schema for a single product configuration.
@@ -112,11 +163,11 @@ export interface ConfigurationResponse {
     /**
      * Product-specific configuration parameters.
      */
-    parameters: SplitV1Parameters | ExtractV2Parameters | ClassifyV2Parameters | ParseV2Parameters | UntypedParameters;
+    parameters: SplitV1Parameters | ExtractV2Parameters | ClassifyV2Parameters | ParseV2Parameters | ConfigurationResponse.SpreadsheetV1Parameters | UntypedParameters;
     /**
      * Product type.
      */
-    product_type: 'split_v1' | 'extract_v2' | 'classify_v2' | 'parse_v2' | 'unknown';
+    product_type: 'split_v1' | 'extract_v2' | 'classify_v2' | 'parse_v2' | 'spreadsheet_v1' | 'unknown';
     /**
      * Version identifier (datetime string).
      */
@@ -130,6 +181,57 @@ export interface ConfigurationResponse {
      */
     updated_at?: string | null;
 }
+export declare namespace ConfigurationResponse {
+    /**
+     * Typed parameters for a _spreadsheet v1_ product configuration.
+     */
+    interface SpreadsheetV1Parameters {
+        /**
+         * Product type.
+         */
+        product_type: 'spreadsheet_v1';
+        /**
+         * A1 notation of the range to extract a single region from. If None, the entire
+         * sheet is used.
+         */
+        extraction_range?: string | null;
+        /**
+         * Return a flattened dataframe when a detected table is recognized as
+         * hierarchical.
+         */
+        flatten_hierarchical_tables?: boolean;
+        /**
+         * Whether to generate additional metadata (title, description) for each extracted
+         * region.
+         */
+        generate_additional_metadata?: boolean;
+        /**
+         * Whether to include hidden cells when extracting regions from the spreadsheet.
+         */
+        include_hidden_cells?: boolean;
+        /**
+         * The names of the sheets to extract regions from. If empty, all sheets will be
+         * processed.
+         */
+        sheet_names?: Array<string> | null;
+        /**
+         * Optional specialization mode for domain-specific extraction. Supported values:
+         * 'financial-standard', 'financial-enhanced', 'financial-precise'. Default None
+         * uses the general-purpose pipeline.
+         */
+        specialization?: string | null;
+        /**
+         * Influences how likely similar-looking regions are merged into a single table.
+         * Useful for spreadsheets that either have sparse tables (strong merging) or many
+         * distinct tables close together (weak merging).
+         */
+        table_merge_sensitivity?: 'strong' | 'weak';
+        /**
+         * Enables experimental processing. Accuracy may be impacted.
+         */
+        use_experimental_processing?: boolean;
+    }
+}
 /**
  * Typed parameters for an _extract v2_ product configuration.
  */
@@ -164,10 +266,6 @@ export interface ExtractV2Parameters {
      * returns one object per page, per_table_row returns one object per table row
      */
     extraction_target?: 'per_doc' | 'per_page' | 'per_table_row';
-    /**
-     * ISO 639-1 language code for the document
-     */
-    lang?: string;
     /**
      * Maximum number of pages to process. Omit for no limit.
      */
@@ -178,7 +276,8 @@ export interface ExtractV2Parameters {
      */
     parse_config_id?: string | null;
     /**
-     * Parse tier to use before extraction (fast, cost_effective, or agentic)
+     * Parse tier to use before extraction. Defaults to the extract tier if not
+     * specified.
      */
     parse_tier?: string | null;
     /**
@@ -217,7 +316,7 @@ export interface ParseV2Parameters {
      * 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' | 'latest' | (string & {});
+    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 & {});
     /**
      * Options for AI-powered parsing tiers (cost_effective, agentic, agentic_plus).
      *
@@ -844,7 +943,7 @@ export declare 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' | 'latest' | (string & {}) | null;
+                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;
             }
             namespace ParsingConf {
                 /**
@@ -1037,7 +1136,7 @@ export interface ConfigurationCreateParams {
     /**
      * Body param: Product-specific configuration parameters.
      */
-    parameters: SplitV1Parameters | ExtractV2Parameters | ClassifyV2Parameters | ParseV2Parameters | UntypedParameters;
+    parameters: SplitV1Parameters | ExtractV2Parameters | ClassifyV2Parameters | ParseV2Parameters | ConfigurationCreateParams.SpreadsheetV1Parameters | UntypedParameters;
     /**
      * Query param
      */
@@ -1047,6 +1146,57 @@ export interface ConfigurationCreateParams {
      */
     project_id?: string | null;
 }
+export declare namespace ConfigurationCreateParams {
+    /**
+     * Typed parameters for a _spreadsheet v1_ product configuration.
+     */
+    interface SpreadsheetV1Parameters {
+        /**
+         * Product type.
+         */
+        product_type: 'spreadsheet_v1';
+        /**
+         * A1 notation of the range to extract a single region from. If None, the entire
+         * sheet is used.
+         */
+        extraction_range?: string | null;
+        /**
+         * Return a flattened dataframe when a detected table is recognized as
+         * hierarchical.
+         */
+        flatten_hierarchical_tables?: boolean;
+        /**
+         * Whether to generate additional metadata (title, description) for each extracted
+         * region.
+         */
+        generate_additional_metadata?: boolean;
+        /**
+         * Whether to include hidden cells when extracting regions from the spreadsheet.
+         */
+        include_hidden_cells?: boolean;
+        /**
+         * The names of the sheets to extract regions from. If empty, all sheets will be
+         * processed.
+         */
+        sheet_names?: Array<string> | null;
+        /**
+         * Optional specialization mode for domain-specific extraction. Supported values:
+         * 'financial-standard', 'financial-enhanced', 'financial-precise'. Default None
+         * uses the general-purpose pipeline.
+         */
+        specialization?: string | null;
+        /**
+         * Influences how likely similar-looking regions are merged into a single table.
+         * Useful for spreadsheets that either have sparse tables (strong merging) or many
+         * distinct tables close together (weak merging).
+         */
+        table_merge_sensitivity?: 'strong' | 'weak';
+        /**
+         * Enables experimental processing. Accuracy may be impacted.
+         */
+        use_experimental_processing?: boolean;
+    }
+}
 export interface ConfigurationRetrieveParams {
     organization_id?: string | null;
     project_id?: string | null;
@@ -1067,7 +1217,58 @@ export interface ConfigurationUpdateParams {
     /**
      * Body param: Updated parameters (omit to leave unchanged).
      */
-    parameters?: SplitV1Parameters | ExtractV2Parameters | ClassifyV2Parameters | ParseV2Parameters | UntypedParameters | null;
+    parameters?: SplitV1Parameters | ExtractV2Parameters | ClassifyV2Parameters | ParseV2Parameters | ConfigurationUpdateParams.SpreadsheetV1Parameters | UntypedParameters | null;
+}
+export declare namespace ConfigurationUpdateParams {
+    /**
+     * Typed parameters for a _spreadsheet v1_ product configuration.
+     */
+    interface SpreadsheetV1Parameters {
+        /**
+         * Product type.
+         */
+        product_type: 'spreadsheet_v1';
+        /**
+         * A1 notation of the range to extract a single region from. If None, the entire
+         * sheet is used.
+         */
+        extraction_range?: string | null;
+        /**
+         * Return a flattened dataframe when a detected table is recognized as
+         * hierarchical.
+         */
+        flatten_hierarchical_tables?: boolean;
+        /**
+         * Whether to generate additional metadata (title, description) for each extracted
+         * region.
+         */
+        generate_additional_metadata?: boolean;
+        /**
+         * Whether to include hidden cells when extracting regions from the spreadsheet.
+         */
+        include_hidden_cells?: boolean;
+        /**
+         * The names of the sheets to extract regions from. If empty, all sheets will be
+         * processed.
+         */
+        sheet_names?: Array<string> | null;
+        /**
+         * Optional specialization mode for domain-specific extraction. Supported values:
+         * 'financial-standard', 'financial-enhanced', 'financial-precise'. Default None
+         * uses the general-purpose pipeline.
+         */
+        specialization?: string | null;
+        /**
+         * Influences how likely similar-looking regions are merged into a single table.
+         * Useful for spreadsheets that either have sparse tables (strong merging) or many
+         * distinct tables close together (weak merging).
+         */
+        table_merge_sensitivity?: 'strong' | 'weak';
+        /**
+         * Enables experimental processing. Accuracy may be impacted.
+         */
+        use_experimental_processing?: boolean;
+    }
 }
 export interface ConfigurationListParams extends PaginatedCursorParams {
     /**
@@ -1082,7 +1283,7 @@ export interface ConfigurationListParams extends PaginatedCursorParams {
     /**
      * Filter by one or more product types. Repeat the parameter for multiple values.
      */
-    product_type?: Array<'split_v1' | 'extract_v2' | 'classify_v2' | 'parse_v2' | 'unknown'> | null;
+    product_type?: Array<'split_v1' | 'extract_v2' | 'classify_v2' | 'parse_v2' | 'spreadsheet_v1' | 'unknown'> | null;
     project_id?: string | null;
 }
 export interface ConfigurationDeleteParams {