extend-ai 1.11.0 → 1.14.0

package/api/types/BlockMetadata.d.ts

@@ -5,6 +5,12 @@ import type * as Extend from "../index";
 export interface BlockMetadata {
     /** Information about the page this block appears on. */
     page?: Extend.BlockMetadataPage;
+    /** Spreadsheet sheet metadata. Present for blocks parsed from spreadsheet files, such as Excel workbooks. */
+    sheet?: Extend.BlockMetadataSheet;
     /** Text direction for this block's content ("ltr" for left-to-right, "rtl" for right-to-left). */
     textDirection?: Extend.BlockMetadataTextDirection;
+    /** Lowest per-word OCR confidence across words in this block, or `null` when word-level confidence is unavailable. */
+    minOcrConfidence?: number | null;
+    /** Average per-word OCR confidence across words in this block, or `null` when word-level confidence is unavailable. */
+    avgOcrConfidence?: number | null;
 }

package/api/types/BlockMetadataSheet.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Spreadsheet sheet metadata. Present for blocks parsed from spreadsheet files, such as Excel workbooks.
+ */
+export interface BlockMetadataSheet {
+    /** The zero-based index of the sheet in the original workbook. */
+    index: number;
+    /** The name of the sheet in the original workbook. */
+    name: string;
+}

package/api/types/BlockMetadataSheet.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/types/ChunkMetadata.d.ts

@@ -5,4 +5,8 @@ import type * as Extend from "../index";
 export interface ChunkMetadata {
     /** The page range this chunk covers. Often will just be a partial page, in which cases `start` and `end` will be the same. */
     pageRange: Extend.ChunkMetadataPageRange;
+    /** Lowest per-word OCR confidence across words in this chunk, or `null` when word-level confidence is unavailable. */
+    minOcrConfidence?: number | null;
+    /** Average per-word OCR confidence across words in this chunk, or `null` when word-level confidence is unavailable. */
+    avgOcrConfidence?: number | null;
 }

package/api/types/ClassificationNextEntry.d.ts

@@ -1,7 +1,7 @@
 /**
  * A next entry for `CLASSIFY` and `SPLIT` steps. Routes based on the classification result.
  *
- * See the [Configuring Workflows via API guide](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api) for end-to-end examples.
+ * See the [Configuring Workflows via API guide](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows) for end-to-end examples.
  */
 export interface ClassificationNextEntry {
     /** The name of the target step. */

package/api/types/ClassifyBaseProcessor.d.ts

@@ -1,4 +1,4 @@
-/** The base processor to use. For classifiers, this can be either `"classification_performance"` or `"classification_light"`. Defaults to `"classification_performance"` if not provided. See [Classification Changelog](https://docs.extend.ai/2026-02-09/changelog/classification/classification-performance) for more details. */
+/** The base processor to use. For classifiers, this can be either `"classification_performance"` or `"classification_light"`. Defaults to `"classification_performance"` if not provided. See [Classification Changelog](https://docs.extend.ai/2026-02-09/model-versioning/classification/classification-performance) for more details. */
 export declare const ClassifyBaseProcessor: {
     readonly ClassificationPerformance: "classification_performance";
     readonly ClassificationLight: "classification_light";

package/api/types/ClassifyBaseProcessor.js

@@ -2,7 +2,7 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClassifyBaseProcessor = void 0;
-/** The base processor to use. For classifiers, this can be either `"classification_performance"` or `"classification_light"`. Defaults to `"classification_performance"` if not provided. See [Classification Changelog](https://docs.extend.ai/2026-02-09/changelog/classification/classification-performance) for more details. */
+/** The base processor to use. For classifiers, this can be either `"classification_performance"` or `"classification_light"`. Defaults to `"classification_performance"` if not provided. See [Classification Changelog](https://docs.extend.ai/2026-02-09/model-versioning/classification/classification-performance) for more details. */
 exports.ClassifyBaseProcessor = {
     ClassificationPerformance: "classification_performance",
     ClassificationLight: "classification_light",

package/api/types/ClassifyConfig.d.ts

@@ -1,7 +1,7 @@
 import type * as Extend from "../index";
 export interface ClassifyConfig {
     baseProcessor?: Extend.ClassifyBaseProcessor;
-    /** The version of the `"classification_performance"` or `"classification_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Classification Changelog](https://docs.extend.ai/2026-02-09/changelog/classification/classification-performance) for more details. */
+    /** The version of the `"classification_performance"` or `"classification_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Classification Changelog](https://docs.extend.ai/2026-02-09/model-versioning/classification/classification-performance) for more details. */
     baseVersion?: string;
     classifications: Extend.Classifications;
     /** Custom rules to guide the classification process in natural language. */

package/api/types/ClassifyOverrideConfig.d.ts

@@ -5,7 +5,7 @@ import type * as Extend from "../index";
  */
 export interface ClassifyOverrideConfig {
     baseProcessor?: Extend.ClassifyBaseProcessor;
-    /** The version of the `"classification_performance"` or `"classification_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Classification Changelog](https://docs.extend.ai/2026-02-09/changelog/classification/classification-performance) for more details. */
+    /** The version of the `"classification_performance"` or `"classification_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Classification Changelog](https://docs.extend.ai/2026-02-09/model-versioning/classification/classification-performance) for more details. */
     baseVersion?: string;
     classifications?: Extend.Classifications;
     /** Custom rules to guide the classification process in natural language. */

package/api/types/ClassifyRun.d.ts

@@ -79,8 +79,8 @@ export interface ClassifyRun {
     edited: boolean;
     /** The configuration used for this classify run. */
     config: Extend.ClassifyConfig;
-    /** The file that was processed. */
-    file: Extend.FileSummary;
+    /** The file that was processed. `null` when the file could not be accessed or processed (for example a run that failed during file ingestion, or a multi-file batch run). */
+    file: Extend.FileSummary | null;
     /**
      * The ID of the parse run that was used for this classify run.
      *

package/api/types/ClassifyRunSummary.d.ts

@@ -42,8 +42,8 @@ export interface ClassifyRunSummary {
     reviewed: boolean;
     /** Indicates whether the run results have been edited during review. */
     edited: boolean;
-    /** The file that was processed. */
-    file: Extend.FileSummary;
+    /** The file that was processed. `null` when the file could not be accessed or processed (for example a run that failed during file ingestion, or a multi-file batch run). */
+    file: Extend.FileSummary | null;
     /**
      * The ID of the parse run that was used for this classify run.
      *

package/api/types/ClassifyStepDefinition.d.ts

@@ -4,7 +4,7 @@ import type * as Extend from "../index";
  *
  * The classifier reference must include a pinned `version` — `"latest"` is not supported for `CLASSIFY` steps. Use a specific semver string (e.g. `"0.1"`) or `"draft"`. This is because classification IDs used for routing are tied to a specific processor version's config.
  *
- * See the [Classify step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#classify-step).
+ * See the [Classify step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#classify).
  */
 export interface ClassifyStepDefinition {
     name: string;
@@ -15,13 +15,13 @@ export interface ClassifyStepDefinition {
      *
      * The classifier `version` is required and must be a pinned version (semver like `"0.1"` or `"draft"`). `"latest"` is not allowed.
      *
-     * See the [Classify step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#classify-step).
+     * See the [Classify step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#classify).
      */
     config?: Extend.ClassifyStepDefinitionConfig;
     /**
      * Can only be set when `config` is present. Each entry must include a `classificationId` matching a classification `id` from the referenced classifier's configuration. Use the classification's stable `id` (e.g. `"cls_invoice"`), not the `type` string.
      *
-     * See the [Classify step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#classify-step).
+     * See the [Classify step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#classify).
      */
     next?: Extend.ClassificationNextEntry[];
 }

package/api/types/ClassifyStepDefinitionConfig.d.ts

@@ -6,7 +6,7 @@ import type * as Extend from "../index";
  *
  * The classifier `version` is required and must be a pinned version (semver like `"0.1"` or `"draft"`). `"latest"` is not allowed.
  *
- * See the [Classify step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#classify-step).
+ * See the [Classify step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#classify).
  */
 export interface ClassifyStepDefinitionConfig {
     classifier: Extend.ClassifierRef;

package/api/types/CollectStepDefinition.d.ts

@@ -2,7 +2,7 @@ import type * as Extend from "../index";
 /**
  * Collects outputs from multiple upstream branches before continuing.
  *
- * See the [Collect step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#collect-step).
+ * See the [Collect step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#collect).
  */
 export interface CollectStepDefinition {
     name: string;

package/api/types/ConditionalExtractStepDefinition.d.ts

@@ -4,7 +4,7 @@ import type * as Extend from "../index";
  *
  * Each extractor reference must include an explicit `version`. Valid values are `"latest"`, `"draft"`, or a specific semver string (e.g. `"1.0"`).
  *
- * See the [Conditional Extract step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-extract-step).
+ * See the [Conditional Extract step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional-extract).
  */
 export interface ConditionalExtractStepDefinition {
     name: string;

package/api/types/ConditionalExtractStepDefinitionConfig.d.ts

@@ -6,7 +6,7 @@ export interface ConditionalExtractStepDefinitionConfig {
     /**
      * Formula-based extractor rules for this step. Each rule pairs a formula with an extractor reference. The last rule must have `formula: "TRUE"` as a default catch-all.
      *
-     * See the [Conditional Extract step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-extract-step).
+     * See the [Conditional Extract step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional-extract).
      */
     rules: Extend.ConditionalExtractStepDefinitionConfigRulesItem[];
 }

package/api/types/ConditionalExtractStepDefinitionConfigRulesItem.d.ts

@@ -4,7 +4,7 @@ export interface ConditionalExtractStepDefinitionConfigRulesItem {
     /**
      * The formula that determines when this extractor runs.
      *
-     * See the [Conditional Extract step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-extract-step) and [Formulas](https://docs.extend.ai/2026-02-09/product/workflows/formulas).
+     * See the [Conditional Extract step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional-extract) and [Formulas](https://docs.extend.ai/2026-02-09/workflows/formulas).
      */
     formula: string;
     extractor: Extend.ExtractorRef;

package/api/types/ConditionalNextEntry.d.ts

@@ -1,7 +1,7 @@
 /**
  * A next entry for `CONDITIONAL` steps. Routes based on which condition branch matched.
  *
- * See the [Configuring Workflows via API guide](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api) for end-to-end examples.
+ * See the [Configuring Workflows via API guide](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows) for end-to-end examples.
  */
 export interface ConditionalNextEntry {
     /** The name of the target step. */

package/api/types/ConditionalStepDefinition.d.ts

@@ -2,7 +2,7 @@ import type * as Extend from "../index";
 /**
  * Routes to different next steps based on ordered conditional branches evaluated against upstream step outputs.
  *
- * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-step).
+ * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional).
  */
 export interface ConditionalStepDefinition {
     name: string;
@@ -10,7 +10,7 @@ export interface ConditionalStepDefinition {
     /**
      * Each entry should include a `conditionId` matching a `config.conditions[].id` value.
      *
-     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-step).
+     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional).
      */
     next?: Extend.ConditionalNextEntry[];
 }

package/api/types/ConditionalStepDefinitionConfig.d.ts

@@ -3,7 +3,7 @@ export interface ConditionalStepDefinitionConfig {
     /**
      * Ordered conditional branches for this step. Use `IF` for the first branch, `ELSE_IF` for additional branches, and `ELSE` for the fallback branch.
      *
-     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-step).
+     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional).
      */
     conditions: Extend.ConditionalStepDefinitionConfigConditionsItem[];
 }

package/api/types/ConditionalStepDefinitionConfigConditionsItem.d.ts

@@ -6,19 +6,19 @@ export interface ConditionalStepDefinitionConfigConditionsItem {
     /**
      * The comparison operation for this branch.
      *
-     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-step).
+     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional).
      */
     operation?: Extend.ConditionalStepDefinitionConfigConditionsItemOperation;
     /**
      * The left operand expression. This is typically a workflow variable or dynamic expression.
      *
-     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-step).
+     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional).
      */
     leftOperand?: string;
     /**
      * The right operand value. This is typically a literal comparison value and is omitted for fallback branches like `ELSE`.
      *
-     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-step).
+     * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional).
      */
     rightOperand?: string;
 }

package/api/types/ConditionalStepDefinitionConfigConditionsItemOperation.d.ts

@@ -1,7 +1,7 @@
 /**
  * The comparison operation for this branch.
  *
- * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-step).
+ * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional).
  */
 export declare const ConditionalStepDefinitionConfigConditionsItemOperation: {
     readonly Equals: "EQUALS";

package/api/types/ConditionalStepDefinitionConfigConditionsItemOperation.js

@@ -5,7 +5,7 @@ exports.ConditionalStepDefinitionConfigConditionsItemOperation = void 0;
 /**
  * The comparison operation for this branch.
  *
- * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#conditional-step).
+ * See the [Conditional step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#conditional).
  */
 exports.ConditionalStepDefinitionConfigConditionsItemOperation = {
     Equals: "EQUALS",

package/api/types/EvaluationSetRun.d.ts

@@ -5,7 +5,7 @@ export interface EvaluationSetRun {
     /**
      * The unique identifier for this evaluation set run.
      *
-     * Example: `"eval_set_run_Xj8mK2pL9nR4vT7qY5wZ"`
+     * Example: `"bpr_Xj8mK2pL9nR4vT7qY5wZ"`
      */
     id: string;
     /**

package/api/types/ExternalDataValidationStepDefinition.d.ts

@@ -2,7 +2,7 @@ import type * as Extend from "../index";
 /**
  * Sends extraction data to an external HTTP endpoint for validation.
  *
- * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+ * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
  */
 export interface ExternalDataValidationStepDefinition {
     name: string;

package/api/types/ExternalDataValidationStepDefinitionConfig.d.ts

@@ -6,13 +6,13 @@ export interface ExternalDataValidationStepDefinitionConfig {
     /**
      * HTTP request configuration for the external validation call.
      *
-     * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+     * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
      */
     requestOptions: Extend.ExternalDataValidationStepDefinitionConfigRequestOptions;
     /**
      * Whether to continue or exit the workflow on validation failure. Defaults to `CONTINUE`.
      *
-     * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+     * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
      */
     failureBehavior?: Extend.ExternalDataValidationStepDefinitionConfigFailureBehavior;
 }

package/api/types/ExternalDataValidationStepDefinitionConfigFailureBehavior.d.ts

@@ -1,7 +1,7 @@
 /**
  * Whether to continue or exit the workflow on validation failure. Defaults to `CONTINUE`.
  *
- * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+ * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
  */
 export declare const ExternalDataValidationStepDefinitionConfigFailureBehavior: {
     readonly Continue: "CONTINUE";

package/api/types/ExternalDataValidationStepDefinitionConfigFailureBehavior.js

@@ -5,7 +5,7 @@ exports.ExternalDataValidationStepDefinitionConfigFailureBehavior = void 0;
 /**
  * Whether to continue or exit the workflow on validation failure. Defaults to `CONTINUE`.
  *
- * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+ * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
  */
 exports.ExternalDataValidationStepDefinitionConfigFailureBehavior = {
     Continue: "CONTINUE",

package/api/types/ExternalDataValidationStepDefinitionConfigRequestOptions.d.ts

@@ -2,7 +2,7 @@ import type * as Extend from "../index";
 /**
  * HTTP request configuration for the external validation call.
  *
- * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+ * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
  */
 export interface ExternalDataValidationStepDefinitionConfigRequestOptions {
     /** The URL to send the validation request to. */
@@ -11,13 +11,13 @@ export interface ExternalDataValidationStepDefinitionConfigRequestOptions {
     /**
      * Optional HTTP headers to include on the external validation request.
      *
-     * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+     * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
      */
     headers?: Record<string, string>;
     /**
      * Content type of the request body sent to the external endpoint.
      *
-     * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+     * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
      */
     contentType?: Extend.ExternalDataValidationStepDefinitionConfigRequestOptionsContentType;
 }

package/api/types/ExternalDataValidationStepDefinitionConfigRequestOptionsContentType.d.ts

@@ -1,7 +1,7 @@
 /**
  * Content type of the request body sent to the external endpoint.
  *
- * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+ * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
  */
 export declare const ExternalDataValidationStepDefinitionConfigRequestOptionsContentType: {
     readonly ApplicationJson: "application/json";

package/api/types/ExternalDataValidationStepDefinitionConfigRequestOptionsContentType.js

@@ -5,7 +5,7 @@ exports.ExternalDataValidationStepDefinitionConfigRequestOptionsContentType = vo
 /**
  * Content type of the request body sent to the external endpoint.
  *
- * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#external-data-validation-step).
+ * See the [External Data Validation step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#external-data-validation).
  */
 exports.ExternalDataValidationStepDefinitionConfigRequestOptionsContentType = {
     ApplicationJson: "application/json",

package/api/types/ExtractAdvancedOptions.d.ts

@@ -29,7 +29,7 @@ export interface ExtractAdvancedOptions {
      * and may include additional `insights` of type `issue` or `review_summary` to help identify
      * fields that may need manual review.
      *
-     * To learn more, view the [Review Agent Documentation](https://docs.extend.ai/2026-02-09/product/extraction/review-agent)
+     * To learn more, view the [Review Agent Documentation](https://docs.extend.ai/2026-02-09/extraction/review-agent)
      */
     reviewAgent?: Extend.ExtractAdvancedOptionsReviewAgent;
     /** Whether to include the current date as context for the model during extraction. Defaults to `false`. */

package/api/types/ExtractAdvancedOptionsReviewAgent.d.ts

@@ -4,7 +4,7 @@
  * and may include additional `insights` of type `issue` or `review_summary` to help identify
  * fields that may need manual review.
  *
- * To learn more, view the [Review Agent Documentation](https://docs.extend.ai/2026-02-09/product/extraction/review-agent)
+ * To learn more, view the [Review Agent Documentation](https://docs.extend.ai/2026-02-09/extraction/review-agent)
  */
 export interface ExtractAdvancedOptionsReviewAgent {
     /** Whether to enable the review agent. */

package/api/types/ExtractBaseProcessor.d.ts

@@ -1,4 +1,4 @@
-/** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/changelog/extraction/extraction-performance) for more details. */
+/** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/model-versioning/extraction/extraction-performance) for more details. */
 export declare const ExtractBaseProcessor: {
     readonly ExtractionPerformance: "extraction_performance";
     readonly ExtractionLight: "extraction_light";

package/api/types/ExtractBaseProcessor.js

@@ -2,7 +2,7 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExtractBaseProcessor = void 0;
-/** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/changelog/extraction/extraction-performance) for more details. */
+/** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/model-versioning/extraction/extraction-performance) for more details. */
 exports.ExtractBaseProcessor = {
     ExtractionPerformance: "extraction_performance",
     ExtractionLight: "extraction_light",

package/api/types/ExtractConfigJson.d.ts

@@ -1,16 +1,20 @@
 import type * as Extend from "../index";
 export interface ExtractConfigJson {
     baseProcessor?: Extend.ExtractBaseProcessor;
-    /** The version of the `"extraction_performance"` or `"extraction_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/changelog/extraction/extraction-performance) for more details. */
+    /** The version of the `"extraction_performance"` or `"extraction_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/model-versioning/extraction/extraction-performance) for more details. */
     baseVersion?: string;
-    /** Custom rules to guide the extraction process in natural language. */
+    /**
+     * Custom rules to guide the extraction process in natural language.
+     *
+     * When `schema` is omitted, `extractionRules` also serves as schema generation instructions — for example, `"Invoice with vendor name, line items, and total due"`. Providing focused instructions produces a more targeted inferred schema.
+     */
     extractionRules?: string;
     /**
-     * JSON Schema definition of the data to extract.
+     * JSON Schema definition of the data to extract. **Optional** — if omitted, Extend automatically infers a schema from the document before running extraction. No extractor is required.
      *
-     * See the [JSON Schema guide](https://docs.extend.ai/2026-02-09/product/extraction/schema) for details and examples of schema configuration.
+     * See the [JSON Schema guide](https://docs.extend.ai/2026-02-09/extraction/schema) for details and examples of schema configuration.
      */
-    schema: Extend.JsonObject;
+    schema?: Extend.JsonObject;
     /** Advanced configuration options. */
     advancedOptions?: Extend.ExtractAdvancedOptions;
     /** Configuration options for the parsing process. */

package/api/types/ExtractConfigLegacy.d.ts

@@ -1,8 +1,8 @@
 import type * as Extend from "../index";
 export interface ExtractConfigLegacy {
-    /** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/changelog/extraction/extraction-performance) for more details. */
+    /** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/model-versioning/extraction/extraction-performance) for more details. */
     baseProcessor?: Extend.ExtractConfigLegacyBaseProcessor;
-    /** The version of the `"extraction_performance"` or `"extraction_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/changelog/extraction/extraction-performance) for more details. */
+    /** The version of the `"extraction_performance"` or `"extraction_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/model-versioning/extraction/extraction-performance) for more details. */
     baseVersion?: string;
     /** Custom rules to guide the extraction process in natural language. */
     extractionRules?: string;

package/api/types/ExtractConfigLegacyBaseProcessor.d.ts

@@ -1,4 +1,4 @@
-/** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/changelog/extraction/extraction-performance) for more details. */
+/** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/model-versioning/extraction/extraction-performance) for more details. */
 export declare const ExtractConfigLegacyBaseProcessor: {
     readonly ExtractionPerformance: "extraction_performance";
     readonly ExtractionLight: "extraction_light";

package/api/types/ExtractConfigLegacyBaseProcessor.js

@@ -2,7 +2,7 @@
 // This file was auto-generated by Fern from our API Definition.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExtractConfigLegacyBaseProcessor = void 0;
-/** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/changelog/extraction/extraction-performance) for more details. */
+/** The base processor to use. For extractors, this can be either `"extraction_performance"` or `"extraction_light"`. Defaults to `"extraction_performance"` if not provided. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/model-versioning/extraction/extraction-performance) for more details. */
 exports.ExtractConfigLegacyBaseProcessor = {
     ExtractionPerformance: "extraction_performance",
     ExtractionLight: "extraction_light",

package/api/types/ExtractOutputMetadataValue.d.ts

@@ -14,7 +14,7 @@ export interface ExtractOutputMetadataValue {
      *
      * These scores will be present when the `reviewAgent.enabled` flag is set to `true` in the processor config.
      * If the review agent is enabled but a score is not returned for a field, this value will be `null`.
-     * To learn more, view the [Review Agent Documentation](https://docs.extend.ai/2026-02-09/product/extraction/review-agent)
+     * To learn more, view the [Review Agent Documentation](https://docs.extend.ai/2026-02-09/extraction/review-agent)
      */
     reviewAgentScore?: number | null;
     citations?: Extend.Citation[];

package/api/types/ExtractOverrideConfigJson.d.ts

@@ -5,14 +5,14 @@ import type * as Extend from "../index";
  */
 export interface ExtractOverrideConfigJson {
     baseProcessor?: Extend.ExtractBaseProcessor;
-    /** The version of the `"extraction_performance"` or `"extraction_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/changelog/extraction/extraction-performance) for more details. */
+    /** The version of the `"extraction_performance"` or `"extraction_light"` processor to use. If not provided, the latest stable version for the selected `baseProcessor` will be used automatically. See [Extraction Changelog](https://docs.extend.ai/2026-02-09/model-versioning/extraction/extraction-performance) for more details. */
     baseVersion?: string;
     /** Custom rules to guide the extraction process in natural language. */
     extractionRules?: string;
     /**
      * JSON Schema definition of the data to extract.
      *
-     * See the [JSON Schema guide](https://docs.extend.ai/2026-02-09/product/extraction/schema) for details and examples of schema configuration.
+     * See the [JSON Schema guide](https://docs.extend.ai/2026-02-09/extraction/schema) for details and examples of schema configuration.
      */
     schema?: Extend.JsonObject;
     /** Advanced configuration options. */

package/api/types/ExtractRequestExtractor.d.ts

@@ -1,6 +1,6 @@
 import type * as Extend from "../index";
 /**
- * Reference to an existing extractor. One of `extractor` or `config` must be provided.
+ * Reference to an existing extractor. Mutually exclusive with `config` — provide one or the other, or omit both to have Extend infer a schema from the document.
  */
 export interface ExtractRequestExtractor {
     /** The ID of the extractor to use. */

package/api/types/ExtractRun.d.ts

@@ -15,7 +15,7 @@ export interface ExtractRun {
     /**
      * The final output, either reviewed or initial. This is a union of two possible shapes:
      *
-     * - **[JSON Schema output](https://docs.extend.ai/2026-02-09/product/extraction/output-types):** The current output format, returned for runs created with a JSON Schema config.
+     * - **[JSON Schema output](https://docs.extend.ai/2026-02-09/extraction/response-format):** The current output format, returned for runs created with a JSON Schema config.
      * - **[Legacy output](https://docs.extend.ai/2025-04-21/product/legacy/output-type-legacy):** A legacy output format from a previous API version. This shape is only returned for runs that were originally created with a legacy config.
      *
      * **Availability:** Present when `status` is `"PROCESSED"`.
@@ -48,6 +48,7 @@ export interface ExtractRun {
      * * `PRE_PROCESSING_FAILURE` - An error occurred during preprocessing (e.g., chunking)
      * * `POST_PROCESSING_FAILURE` - An error occurred during postprocessing
      * * `OUT_OF_CREDITS` - Insufficient credits to run the extraction
+     * * `SCHEMA_GENERATION_FAILED` - Automatic schema inference failed (only applies when `schema` is omitted). The file could not be parsed or a schema could not be generated from it.
      *
      * **Note:** Additional failure reasons may be added in the future. Your integration should handle unknown values gracefully.
      */
@@ -77,7 +78,7 @@ export interface ExtractRun {
     /**
      * The configuration used for this extract run. This is a union of two possible shapes:
      *
-     * - **[JSON Schema config](https://docs.extend.ai/2026-02-09/product/extraction/schema):** The current config format. All runs created through this API version use this shape.
+     * - **[JSON Schema config](https://docs.extend.ai/2026-02-09/extraction/schema):** The current config format. All runs created through this API version use this shape.
      * - **[Legacy config](https://docs.extend.ai/2025-04-21/product/legacy/legacy-schema):** A fields-array config from a previous API version. This shape is only returned when retrieving runs that were originally created with the legacy format. This API version does not support creating runs with legacy configs.
      */
     config: Extend.ExtractConfig;
@@ -93,8 +94,8 @@ export interface ExtractRun {
      * **Availability:** Present when an extractor reference was provided. Not present when using inline `config`.
      */
     extractorVersion: Extend.ExtractorVersionSummary | null;
-    /** The file that was processed. */
-    file: Extend.FileSummary;
+    /** The file that was processed. `null` when the file could not be accessed or processed (for example a run that failed during file ingestion, or a multi-file batch run). */
+    file: Extend.FileSummary | null;
     /**
      * The ID of the parse run that was used for this extract run.
      *

package/api/types/ExtractRunSummary.d.ts

@@ -24,6 +24,20 @@ export interface ExtractRunSummary {
      * The reason for failure.
      *
      * **Availability:** Present when `status` is `"FAILED"`.
+     *
+     * Possible values include:
+     * * `ABORTED` - The run was aborted by the user
+     * * `INTERNAL_ERROR` - An unexpected internal error occurred
+     * * `FAILED_TO_PROCESS_FILE` - Failed to process the file (e.g., OCR failure, file access issues)
+     * * `INVALID_PROCESSOR` - The processor configuration is invalid
+     * * `INVALID_CONFIGURATION` - The provided configuration is incompatible with the selected model
+     * * `PARSING_ERROR` - Failed to parse the extraction output
+     * * `PRE_PROCESSING_FAILURE` - An error occurred during preprocessing (e.g., chunking)
+     * * `POST_PROCESSING_FAILURE` - An error occurred during postprocessing
+     * * `OUT_OF_CREDITS` - Insufficient credits to run the extraction
+     * * `SCHEMA_GENERATION_FAILED` - Automatic schema inference failed (only applies when `schema` is omitted). The file could not be parsed or a schema could not be generated from it.
+     *
+     * **Note:** Additional failure reasons may be added in the future. Your integration should handle unknown values gracefully.
      */
     failureReason: string | null;
     /**
@@ -42,8 +56,8 @@ export interface ExtractRunSummary {
     reviewed: boolean;
     /** Indicates whether the run results have been edited during review. */
     edited: boolean;
-    /** The file that was processed. */
-    file: Extend.FileSummary;
+    /** The file that was processed. `null` when the file could not be accessed or processed (for example a run that failed during file ingestion, or a multi-file batch run). */
+    file: Extend.FileSummary | null;
     /**
      * The ID of the parse run that was used for this extract run.
      *

package/api/types/ExtractStepDefinition.d.ts

@@ -4,7 +4,7 @@ import type * as Extend from "../index";
  *
  * The extractor reference must include an explicit `version`. Valid values are `"latest"`, `"draft"`, or a specific semver string (e.g. `"1.0"`).
  *
- * See the [Extract step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#extract-step).
+ * See the [Extract step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#extract).
  */
 export interface ExtractStepDefinition {
     name: string;