extend-ai 1.13.0 → 1.15.0

package/BaseClient.js

@@ -44,8 +44,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "extend-ai",
-        "X-Fern-SDK-Version": "1.13.0",
-        "User-Agent": "extend-ai/1.13.0",
+        "X-Fern-SDK-Version": "1.15.0",
+        "User-Agent": "extend-ai/1.15.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "x-extend-api-version": (_a = options === null || options === void 0 ? void 0 : options.extendApiVersion) !== null && _a !== void 0 ? _a : "2026-02-09",

package/Client.d.ts

@@ -163,7 +163,9 @@ export declare class ExtendClient {
      *
      * **Note:** This endpoint is intended for onboarding and testing only. For production workloads, use `POST /extract_runs` with [polling or webhooks](https://docs.extend.ai/2026-02-09/general/async-processing) instead, as it provides better reliability for large files and avoids timeout issues.
      *
-     * The Extract endpoint allows you to extract structured data from files using an existing extractor or an inline configuration.
+     * The Extract endpoint allows you to extract structured data from files using an existing extractor, an inline configuration, or no configuration at all. When neither is provided, Extend automatically infers a schema from the document before extraction — no extractor or schema is required.
+     *
+     * Pass `file` for a single document, or `package` to extract from multiple files in a single run. Exactly one of `file` or `package` must be provided.
      *
      * For more details, see the [Extract File guide](https://docs.extend.ai/2026-02-09/extraction/overview).
      *
@@ -224,7 +226,7 @@ export declare class ExtendClient {
      *         }
      *     })
      */
-    extract(request: Extend.ExtractRequest, requestOptions?: ExtendClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractRun>;
+    extract(request?: Extend.ExtractRequest, requestOptions?: ExtendClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractRun>;
     private __extract;
     /**
      * Classify a document synchronously, waiting for the result before returning. This endpoint has a **5-minute timeout** — if processing takes longer, the request will fail.

package/Client.js

@@ -384,7 +384,9 @@ class ExtendClient {
      *
      * **Note:** This endpoint is intended for onboarding and testing only. For production workloads, use `POST /extract_runs` with [polling or webhooks](https://docs.extend.ai/2026-02-09/general/async-processing) instead, as it provides better reliability for large files and avoids timeout issues.
      *
-     * The Extract endpoint allows you to extract structured data from files using an existing extractor or an inline configuration.
+     * The Extract endpoint allows you to extract structured data from files using an existing extractor, an inline configuration, or no configuration at all. When neither is provided, Extend automatically infers a schema from the document before extraction — no extractor or schema is required.
+     *
+     * Pass `file` for a single document, or `package` to extract from multiple files in a single run. Exactly one of `file` or `package` must be provided.
      *
      * For more details, see the [Extract File guide](https://docs.extend.ai/2026-02-09/extraction/overview).
      *
@@ -445,11 +447,11 @@ class ExtendClient {
      *         }
      *     })
      */
-    extract(request, requestOptions) {
+    extract(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__extract(request, requestOptions));
     }
-    __extract(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __extract() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "x-extend-api-version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.extendApiVersion) !== null && _b !== void 0 ? _b : "2026-02-09" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/api/client/requests/ExtractRequest.d.ts

@@ -46,11 +46,21 @@ import type * as Extend from "../../index";
  *     }
  */
 export interface ExtractRequest {
-    /** 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. */
     extractor?: Extend.ExtractRequestExtractor;
-    /** Inline extract configuration. One of `extractor` or `config` must be provided. */
+    /** Inline extract configuration. Mutually exclusive with `extractor` — provide one or the other, or omit both to have Extend infer a schema from the document. */
     config?: Extend.ExtractConfigJson;
-    /** The file to be extracted from. Files can be provided as a URL, Extend file ID, or raw text. */
-    file: Extend.ExtractRequestFile;
+    /**
+     * The file to be extracted from. Mutually exclusive with `package` — provide one or the other.
+     *
+     * Files can be provided as a URL, Extend file ID, or raw text.
+     */
+    file?: Extend.ExtractRequestFile;
+    /**
+     * A collection of files to extract from together in a single run. Mutually exclusive with `file` — provide one or the other.
+     *
+     * See [Multifile Extraction](https://docs.extend.ai/2026-02-09/extraction/multifile) for details.
+     */
+    package?: Extend.MultiFileRunPackage;
     metadata?: Extend.RunMetadata;
 }

package/api/resources/extractRuns/client/Client.d.ts

@@ -60,8 +60,22 @@ export declare class ExtractRunsClient {
      *             url: "https://example.com/invoice.pdf"
      *         }
      *     })
+     *
+     * @example
+     *     await client.extractRuns.create({
+     *         extractor: {
+     *             id: "ex_1234567890"
+     *         },
+     *         "package": {
+     *             files: [{
+     *                     url: "https://example.com/invoice1.pdf"
+     *                 }, {
+     *                     url: "https://example.com/invoice2.pdf"
+     *                 }]
+     *         }
+     *     })
      */
-    create(request: Extend.ExtractRunsCreateRequest, requestOptions?: ExtractRunsClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractRun>;
+    create(request?: Extend.ExtractRunsCreateRequest, requestOptions?: ExtractRunsClient.RequestOptions): core.HttpResponsePromise<Extend.ExtractRun>;
     private __create;
     /**
      * Retrieve details about a specific extract run, including its status, outputs, and any edits made during review.

package/api/resources/extractRuns/client/Client.js

@@ -170,12 +170,26 @@ class ExtractRunsClient {
      *             url: "https://example.com/invoice.pdf"
      *         }
      *     })
+     *
+     * @example
+     *     await client.extractRuns.create({
+     *         extractor: {
+     *             id: "ex_1234567890"
+     *         },
+     *         "package": {
+     *             files: [{
+     *                     url: "https://example.com/invoice1.pdf"
+     *                 }, {
+     *                     url: "https://example.com/invoice2.pdf"
+     *                 }]
+     *         }
+     *     })
      */
-    create(request, requestOptions) {
+    create(request = {}, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
     }
-    __create(request, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
+    __create() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ "x-extend-api-version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.extendApiVersion) !== null && _b !== void 0 ? _b : "2026-02-09" }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/api/resources/extractRuns/client/requests/ExtractRunsCreateRequest.d.ts

@@ -9,14 +9,38 @@ import type * as Extend from "../../../../index";
  *             url: "https://example.com/invoice.pdf"
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         extractor: {
+ *             id: "ex_1234567890"
+ *         },
+ *         "package": {
+ *             files: [{
+ *                     url: "https://example.com/invoice1.pdf"
+ *                 }, {
+ *                     url: "https://example.com/invoice2.pdf"
+ *                 }]
+ *         }
+ *     }
  */
 export interface ExtractRunsCreateRequest {
-    /** 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. */
     extractor?: Extend.ExtractRunsCreateRequestExtractor;
-    /** Inline extract configuration. One of `extractor` or `config` must be provided. */
+    /** Inline extract configuration. Mutually exclusive with `extractor` — provide one or the other, or omit both to have Extend infer a schema from the document. */
     config?: Extend.ExtractConfigJson;
-    /** The file to be extracted from. Files can be provided as a URL, Extend file ID, or raw text. */
-    file: Extend.ExtractRunsCreateRequestFile;
+    /**
+     * The file to be extracted from. Mutually exclusive with `package` — provide one or the other.
+     *
+     * Files can be provided as a URL, Extend file ID, or raw text.
+     */
+    file?: Extend.ExtractRunsCreateRequestFile;
+    /**
+     * A collection of files to extract from together in a single run. Mutually exclusive with `file` — provide one or the other.
+     *
+     * See [Multifile Extraction](https://docs.extend.ai/2026-02-09/extraction/multifile) for details.
+     */
+    package?: Extend.MultiFileRunPackage;
     priority?: Extend.RunPriority;
     metadata?: Extend.RunMetadata;
 }

package/api/resources/extractRuns/types/ExtractRunsCreateRequestExtractor.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 ExtractRunsCreateRequestExtractor {
     /** The ID of the extractor to use. */

package/api/resources/extractRuns/types/ExtractRunsCreateRequestFile.d.ts

@@ -1,5 +1,7 @@
 import type * as Extend from "../../../index";
 /**
- * The file to be extracted from. Files can be provided as a URL, Extend file ID, or raw text.
+ * The file to be extracted from. Mutually exclusive with `package` — provide one or the other.
+ *
+ * Files can be provided as a URL, Extend file ID, or raw text.
  */
 export type ExtractRunsCreateRequestFile = Extend.FileFromUrl | Extend.FileFromId | Extend.FileFromText;

package/api/resources/parseRuns/client/Client.d.ts

@@ -113,6 +113,31 @@ export declare class ParseRunsClient {
      */
     delete(id: string, request?: Extend.ParseRunsDeleteRequest, requestOptions?: ParseRunsClient.RequestOptions): core.HttpResponsePromise<Extend.ParseRunsDeleteResponse>;
     private __delete;
+    /**
+     * Cancel an in-progress parse run.
+     *
+     * Note: Only parse runs with a status of `"PROCESSING"` can be cancelled. Parse runs that have already completed, failed, or been cancelled cannot be cancelled again.
+     *
+     * @param {string} id - The ID of the parse run to cancel.
+     *
+     *                      Example: `"pr_xK9mLPqRtN3vS8wF5hB2cQ"`
+     * @param {Extend.ParseRunsCancelRequest} request
+     * @param {ParseRunsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Extend.BadRequestError}
+     * @throws {@link Extend.UnauthorizedError}
+     * @throws {@link Extend.PaymentRequiredError}
+     * @throws {@link Extend.ForbiddenError}
+     * @throws {@link Extend.NotFoundError}
+     * @throws {@link Extend.UnprocessableEntityError}
+     * @throws {@link Extend.TooManyRequestsError}
+     * @throws {@link Extend.InternalServerError}
+     *
+     * @example
+     *     await client.parseRuns.cancel("parse_run_id_here")
+     */
+    cancel(id: string, request?: Extend.ParseRunsCancelRequest, requestOptions?: ParseRunsClient.RequestOptions): core.HttpResponsePromise<Extend.ParseRun>;
+    private __cancel;
     /**
      * Submit up to **1,000 files** for parsing in a single request. Each file is processed as an independent parse run using the same configuration.
      *

package/api/resources/parseRuns/client/Client.js

@@ -381,6 +381,84 @@ class ParseRunsClient {
             return (0, handleNonStatusCodeError_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "DELETE", "/parse_runs/{id}");
         });
     }
+    /**
+     * Cancel an in-progress parse run.
+     *
+     * Note: Only parse runs with a status of `"PROCESSING"` can be cancelled. Parse runs that have already completed, failed, or been cancelled cannot be cancelled again.
+     *
+     * @param {string} id - The ID of the parse run to cancel.
+     *
+     *                      Example: `"pr_xK9mLPqRtN3vS8wF5hB2cQ"`
+     * @param {Extend.ParseRunsCancelRequest} request
+     * @param {ParseRunsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Extend.BadRequestError}
+     * @throws {@link Extend.UnauthorizedError}
+     * @throws {@link Extend.PaymentRequiredError}
+     * @throws {@link Extend.ForbiddenError}
+     * @throws {@link Extend.NotFoundError}
+     * @throws {@link Extend.UnprocessableEntityError}
+     * @throws {@link Extend.TooManyRequestsError}
+     * @throws {@link Extend.InternalServerError}
+     *
+     * @example
+     *     await client.parseRuns.cancel("parse_run_id_here")
+     */
+    cancel(id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__cancel(id, request, requestOptions));
+    }
+    __cancel(id_1) {
+        return __awaiter(this, arguments, void 0, function* (id, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const { "x-extend-workspace-id": extendWorkspaceId } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({
+                "x-extend-workspace-id": extendWorkspaceId,
+                "x-extend-api-version": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.extendApiVersion) !== null && _b !== void 0 ? _b : "2026-02-09",
+            }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_c = this._options.fetcher) !== null && _c !== void 0 ? _c : core.fetcher)({
+                url: core.url.join((_e = (_d = (yield core.Supplier.get(this._options.baseUrl))) !== null && _d !== void 0 ? _d : (yield core.Supplier.get(this._options.environment))) !== null && _e !== void 0 ? _e : environments.ExtendEnvironment.Production, `parse_runs/${core.url.encodePathParam(id)}/cancel`),
+                method: "POST",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_h = (_f = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _f !== void 0 ? _f : (_g = this._options) === null || _g === void 0 ? void 0 : _g.timeoutInSeconds) !== null && _h !== void 0 ? _h : 300) * 1000,
+                maxRetries: (_j = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _j !== void 0 ? _j : (_k = this._options) === null || _k === void 0 ? void 0 : _k.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_l = this._options) === null || _l === void 0 ? void 0 : _l.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Extend.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Extend.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 402:
+                        throw new Extend.PaymentRequiredError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Extend.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Extend.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Extend.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Extend.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Extend.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.ExtendError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/parse_runs/{id}/cancel");
+        });
+    }
     /**
      * Submit up to **1,000 files** for parsing in a single request. Each file is processed as an independent parse run using the same configuration.
      *

package/api/resources/parseRuns/client/requests/ParseRunsCancelRequest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @example
+ *     {}
+ */
+export interface ParseRunsCancelRequest {
+    /** The workspace ID to target. **Required** when using an organization-scoped API key; optional for workspace-scoped keys (the key is already tied to a workspace). See [Authentication](https://docs.extend.ai/2026-02-09/api-reference/authentication) for details on API key scopes. */
+    "x-extend-workspace-id"?: string;
+}

package/api/resources/parseRuns/client/requests/ParseRunsCancelRequest.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/resources/parseRuns/client/requests/index.d.ts

@@ -1,3 +1,4 @@
+export type { ParseRunsCancelRequest } from "./ParseRunsCancelRequest";
 export type { ParseRunsCreateBatchRequest } from "./ParseRunsCreateBatchRequest";
 export type { ParseRunsCreateRequest } from "./ParseRunsCreateRequest";
 export type { ParseRunsDeleteRequest } from "./ParseRunsDeleteRequest";

package/api/resources/parseRuns/types/ParseRunsListResponse.d.ts

@@ -1,6 +1,6 @@
 import type * as Extend from "../../../index";
 export interface ParseRunsListResponse {
     object: "list";
-    data: Extend.ParseRun[];
+    data: Extend.ParseRunSummary[];
     nextPageToken?: Extend.NextPageToken;
 }

package/api/resources/workflowRuns/client/Client.d.ts

@@ -170,7 +170,7 @@ export declare class WorkflowRunsClient {
      *
      * Our recommended usage pattern is to integrate with [Webhooks](https://docs.extend.ai/2026-02-09/webhooks/configuration) for consuming results, using the `metadata` and `batchId` to match up results to the original inputs in your downstream systems. However, you can integrate in a polling mechanism by using a combination of the [List Workflow Runs](https://docs.extend.ai/2026-02-09/api-reference/endpoints/workflow/list-workflow-runs) endpoint to fetch all runs via a batch, and then [Get Workflow Run](https://docs.extend.ai/2026-02-09/api-reference/endpoints/workflow/get-workflow-run) to fetch the full outputs each run.
      *
-     * **Priority:** All workflow runs created through this batch endpoint are automatically assigned a priority of 90.
+     * **Priority:** By default, workflow runs created through this batch endpoint are assigned a priority of 90. You can override this by passing an optional `priority` value (1–100) in the request body — lower values run first.
      *
      * **Processing and Monitoring:**
      * Upon successful submission, the endpoint returns a `batchId`. The individual workflow runs are then queued for processing.

package/api/resources/workflowRuns/client/Client.js

@@ -556,7 +556,7 @@ class WorkflowRunsClient {
      *
      * Our recommended usage pattern is to integrate with [Webhooks](https://docs.extend.ai/2026-02-09/webhooks/configuration) for consuming results, using the `metadata` and `batchId` to match up results to the original inputs in your downstream systems. However, you can integrate in a polling mechanism by using a combination of the [List Workflow Runs](https://docs.extend.ai/2026-02-09/api-reference/endpoints/workflow/list-workflow-runs) endpoint to fetch all runs via a batch, and then [Get Workflow Run](https://docs.extend.ai/2026-02-09/api-reference/endpoints/workflow/get-workflow-run) to fetch the full outputs each run.
      *
-     * **Priority:** All workflow runs created through this batch endpoint are automatically assigned a priority of 90.
+     * **Priority:** By default, workflow runs created through this batch endpoint are assigned a priority of 90. You can override this by passing an optional `priority` value (1–100) in the request body — lower values run first.
      *
      * **Processing and Monitoring:**
      * Upon successful submission, the endpoint returns a `batchId`. The individual workflow runs are then queued for processing.

package/api/resources/workflowRuns/client/requests/WorkflowRunsCreateBatchRequest.d.ts

@@ -26,4 +26,6 @@ export interface WorkflowRunsCreateBatchRequest {
     workflow: Extend.WorkflowReference;
     /** An array of input objects to be processed by the workflow. Each object represents a single workflow run to be created. The array must contain at least 1 input and at most 1000 inputs. */
     inputs: Extend.WorkflowRunsCreateBatchRequestInputsItem[];
+    /** An optional value used to determine the relative order of runs when rate limiting is in effect. Lower values will be prioritized before higher values. Defaults to 90 if not specified. */
+    priority?: number;
 }

package/api/types/ExtractConfigJson.d.ts

@@ -3,14 +3,18 @@ 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/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/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/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/ExtractRequestFile.d.ts

@@ -1,5 +1,7 @@
 import type * as Extend from "../index";
 /**
- * The file to be extracted from. Files can be provided as a URL, Extend file ID, or raw text.
+ * The file to be extracted from. Mutually exclusive with `package` — provide one or the other.
+ *
+ * Files can be provided as a URL, Extend file ID, or raw text.
  */
 export type ExtractRequestFile = Extend.FileFromUrl | Extend.FileFromId | Extend.FileFromText;

package/api/types/ExtractRun.d.ts

@@ -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.
      */
@@ -93,8 +94,14 @@ 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. `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). */
+    /** The file that was processed. `null` for multifile runs (use `files` instead), and `null` when the file could not be accessed or processed (for example, a run that failed during file ingestion). */
     file: Extend.FileSummary | null;
+    /**
+     * The files that were processed, in the order they were submitted. Only populated for multifile runs (created with `package`).
+     *
+     * For single-file runs, this is `null` — use `file` instead.
+     */
+    files: 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,14 @@ export interface ExtractRunSummary {
     reviewed: boolean;
     /** Indicates whether the run results have been edited during review. */
     edited: boolean;
-    /** 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). */
+    /** The file that was processed. `null` for multifile runs (use `files` instead), and `null` when the file could not be accessed or processed (for example, a run that failed during file ingestion). */
     file: Extend.FileSummary | null;
+    /**
+     * The files that were processed, in the order they were submitted. Only populated for multifile runs (created with `package`).
+     *
+     * For single-file runs, this is `null` — use `file` instead.
+     */
+    files: Extend.FileSummary[] | null;
     /**
      * The ID of the parse run that was used for this extract run.
      *

package/api/types/MultiFileRunPackage.d.ts

@@ -0,0 +1,10 @@
+import type * as Extend from "../index";
+/**
+ * An ordered collection of files to extract from together in a single run. Use this instead of `file` when you want to run extraction across multiple documents at once.
+ *
+ * Exactly one of `file` or `package` must be provided on a request — they are mutually exclusive.
+ */
+export interface MultiFileRunPackage {
+    /** The files to extract from. Each entry can be a URL or an existing Extend file ID. */
+    files: Extend.MultiFileRunPackageFilesItem[];
+}

package/api/types/MultiFileRunPackage.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/MultiFileRunPackageFilesItem.d.ts

@@ -0,0 +1,2 @@
+import type * as Extend from "../index";
+export type MultiFileRunPackageFilesItem = Extend.FileFromUrl | Extend.FileFromId;

package/api/types/MultiFileRunPackageFilesItem.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/ParseConfigBlockOptionsFigures.d.ts

@@ -8,4 +8,6 @@ export interface ParseConfigBlockOptionsFigures {
     figureImageClippingEnabled?: boolean;
     /** Whether to enable advanced chart extraction using vision models for improved data extraction from charts. */
     advancedChartExtractionEnabled?: boolean;
+    /** Custom instructions injected into the vision model prompt used to analyze and summarize figures. Use to steer figure descriptions toward your use case (e.g. domain terminology, details to always capture). Requires `enabled: true`. Available on `parse_performance` >= `2.0.0` and `parse_light` >= `1.0.0`. */
+    customInstructions?: string;
 }

package/api/types/ParseRun.d.ts

@@ -58,6 +58,12 @@ export interface ParseRun {
      * **Availability:** Present when `status` is `"FAILED"`.
      */
     failureMessage: string | null;
+    /**
+     * Any metadata that was provided when creating the parse run.
+     *
+     * **Availability:** Present when metadata was provided during creation.
+     */
+    metadata: Extend.RunMetadata | null;
     /**
      * The parse run output.
      *

package/api/types/ParseRunSummary.d.ts

@@ -0,0 +1,81 @@
+import type * as Extend from "../index";
+/**
+ * Summary representation of a parse run.
+ */
+export interface ParseRunSummary {
+    /** The type of object. Will always be `"parse_run"`. */
+    object: "parse_run";
+    /**
+     * A unique identifier for the parse run.
+     *
+     * Example: `"pr_xK9mLPqRtN3vS8wF5hB2cQ"`
+     */
+    id: string;
+    /**
+     * The ID of the batch this run belongs to, if created via `POST /parse_runs/batch`.
+     *
+     * **Availability:** Present when the run was submitted as part of a batch.
+     *
+     * Example: `"bpar_Xj8mK2pL9nR4vT7qY5wZ"`
+     */
+    batchId: string | null;
+    /** The file that was parsed. This file can be used as a parameter for other Extend endpoints, such as `POST /workflow_runs`. May be `null` for batch parse runs where file ingestion failed. */
+    file: Extend.FileSummary;
+    /**
+     * The status of the parse run:
+     * * `"PENDING"` - The run has been created and is waiting to be processed. Only applies to runs created via `POST /parse_runs/batch`.
+     * * `"PROCESSING"` - The file is still being processed
+     * * `"PROCESSED"` - The file was successfully processed
+     * * `"FAILED"` - The processing failed (see `failureReason` for details)
+     */
+    status: Extend.ParseRunSummaryStatus;
+    /**
+     * The reason for failure.
+     *
+     * **Availability:** Present when `status` is `"FAILED"`.
+     *
+     * Possible values include:
+     * * `UNABLE_TO_DOWNLOAD_FILE` - The file could not be downloaded from the provided URL
+     * * `FILE_TYPE_NOT_SUPPORTED` - The file type is not supported for parsing
+     * * `FILE_SIZE_TOO_LARGE` - The file exceeds the maximum allowed size
+     * * `CORRUPT_FILE` - The file appears to be corrupted or malformed
+     * * `OCR_ERROR` - An error occurred during optical character recognition
+     * * `PASSWORD_PROTECTED_FILE` - The file is password protected and cannot be processed
+     * * `FAILED_TO_CONVERT_TO_PDF` - The file could not be converted to PDF for processing
+     * * `FAILED_TO_CONVERT_TO_JPEG` - The file could not be converted to JPEG for processing
+     * * `FAILED_TO_GENERATE_TARGET_FORMAT` - The output could not be generated in the requested format
+     * * `CHUNKING_ERROR` - An error occurred while chunking the document
+     * * `INTERNAL_ERROR` - An unexpected internal error occurred
+     * * `INVALID_CONFIG_OPTIONS` - The provided configuration options are invalid
+     * * `OUT_OF_CREDITS` - Insufficient credits to process the file
+     *
+     * **Note:** Additional failure reasons may be added in the future. Your integration should handle unknown values gracefully.
+     */
+    failureReason: string | null;
+    /**
+     * A human-readable description of the failure.
+     *
+     * **Availability:** Present when `status` is `"FAILED"`.
+     */
+    failureMessage: string | null;
+    /**
+     * Any metadata that was provided when creating the parse run.
+     *
+     * **Availability:** Present when metadata was provided during creation.
+     */
+    metadata: Extend.RunMetadata | null;
+    /**
+     * Metrics about the parsing process.
+     *
+     * **Availability:** Present when `status` is `"PROCESSED"`.
+     */
+    metrics: Extend.ParseRunSummaryMetrics | null;
+    /**
+     * Usage credits consumed by this parse run. Omits `breakdown` — fetch the full parse run by id to see the per-line items.
+     *
+     * **Availability:** Present when `status` is `"PROCESSED"`, the run was created after October 7, 2025, and the customer is on the current billing system.
+     */
+    usage: Extend.RunUsageSummary | null;
+    createdAt: Extend.CreatedAt;
+    updatedAt: Extend.UpdatedAt;
+}

package/api/types/ParseRunSummary.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/ParseRunSummaryMetrics.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Metrics about the parsing process.
+ *
+ * **Availability:** Present when `status` is `"PROCESSED"`.
+ */
+export interface ParseRunSummaryMetrics {
+    /** The time taken to process the document in milliseconds. */
+    processingTimeMs: number;
+    /** The number of pages from the document that were parsed. For PDF and image files, this is the actual page count. For spreadsheet files (Excel, CSV), this is an estimated page count based on content volume (~1000 tokens per page). */
+    pageCount: number;
+}

package/api/types/ParseRunSummaryMetrics.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/ParseRunSummaryStatus.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The status of the parse run:
+ * * `"PENDING"` - The run has been created and is waiting to be processed. Only applies to runs created via `POST /parse_runs/batch`.
+ * * `"PROCESSING"` - The file is still being processed
+ * * `"PROCESSED"` - The file was successfully processed
+ * * `"FAILED"` - The processing failed (see `failureReason` for details)
+ */
+export declare const ParseRunSummaryStatus: {
+    readonly Pending: "PENDING";
+    readonly Processing: "PROCESSING";
+    readonly Processed: "PROCESSED";
+    readonly Failed: "FAILED";
+};
+export type ParseRunSummaryStatus = (typeof ParseRunSummaryStatus)[keyof typeof ParseRunSummaryStatus] | string;

package/api/types/ParseRunSummaryStatus.js

@@ -0,0 +1,17 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseRunSummaryStatus = void 0;
+/**
+ * The status of the parse run:
+ * * `"PENDING"` - The run has been created and is waiting to be processed. Only applies to runs created via `POST /parse_runs/batch`.
+ * * `"PROCESSING"` - The file is still being processed
+ * * `"PROCESSED"` - The file was successfully processed
+ * * `"FAILED"` - The processing failed (see `failureReason` for details)
+ */
+exports.ParseRunSummaryStatus = {
+    Pending: "PENDING",
+    Processing: "PROCESSING",
+    Processed: "PROCESSED",
+    Failed: "FAILED",
+};

package/api/types/RunUsageBreakdownCharge.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A single cost driver within a breakdown entry's credit total. The per-unit rate is `credits / quantity`.
+ */
+export interface RunUsageBreakdownCharge {
+    /** Identifier for the billable cost driver. */
+    product: string;
+    /** The unit `quantity` is measured in. */
+    unit: string;
+    /** How many units this charge was billed for. */
+    quantity: number;
+    /** Credits consumed by this charge. */
+    credits: number;
+    /** 1-indexed page numbers that incurred this charge. Present on usage-based add-ons that are only billed for the pages where they actually applied (e.g. `agentic_text_correction`, `agentic_table_correction`). */
+    pages?: number[];
+}

package/api/types/RunUsageBreakdownCharge.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/RunUsageBreakdownEntry.d.ts

@@ -1,6 +1,6 @@
 import type * as Extend from "../index";
 /**
- * One line item in a run's `usage.breakdown`. Each entry corresponds to a concrete chargeable resource that contributed credits to the parent operation.
+ * One line item in a run's `usage.breakdown`. Each entry corresponds to a concrete chargeable resource that contributed credits to the parent operation. When `charges` is present, it itemizes the cost drivers behind this entry's `credits`.
  */
 export interface RunUsageBreakdownEntry {
     /** The public object type of the contributing resource. Mirrors the top-level `object` field on the corresponding endpoint so callers can fetch the underlying resource by id if they want more detail. */
@@ -9,4 +9,10 @@ export interface RunUsageBreakdownEntry {
     id: string;
     /** Credits charged to the contributing resource. */
     credits: number;
+    /**
+     * Itemized cost drivers that make up this entry's `credits`. When present, `sum(charges[].credits) === credits`.
+     *
+     * **Availability:** Present on runs persisted on or after June 10, 2026. Runs persisted before that date will omit this field.
+     */
+    charges?: Extend.RunUsageBreakdownCharge[];
 }

package/api/types/index.d.ts

@@ -266,6 +266,8 @@ export * from "./MergeExtractStepDefinitionConfig";
 export * from "./MergeExtractStepDefinitionConfigMergeOrder";
 export * from "./MergeExtractStepRun";
 export * from "./MergeExtractStepRunStep";
+export * from "./MultiFileRunPackage";
+export * from "./MultiFileRunPackageFilesItem";
 export * from "./NextPageToken";
 export * from "./PageRanges";
 export * from "./PageRangesItem";
@@ -306,6 +308,9 @@ export * from "./ParseRunSource";
 export * from "./ParseRunStatus";
 export * from "./ParseRunStatusEnum";
 export * from "./ParseRunStatusStatus";
+export * from "./ParseRunSummary";
+export * from "./ParseRunSummaryMetrics";
+export * from "./ParseRunSummaryStatus";
 export * from "./ParseStepDefinition";
 export * from "./ParseStepDefinitionConfig";
 export * from "./ParseStepRun";
@@ -335,6 +340,7 @@ export * from "./RunSecrets";
 export * from "./RunSource";
 export * from "./RunSourceId";
 export * from "./RunUsage";
+export * from "./RunUsageBreakdownCharge";
 export * from "./RunUsageBreakdownEntry";
 export * from "./RunUsageBreakdownEntryObject";
 export * from "./RunUsageSummary";

package/api/types/index.js

@@ -282,6 +282,8 @@ __exportStar(require("./MergeExtractStepDefinitionConfig"), exports);
 __exportStar(require("./MergeExtractStepDefinitionConfigMergeOrder"), exports);
 __exportStar(require("./MergeExtractStepRun"), exports);
 __exportStar(require("./MergeExtractStepRunStep"), exports);
+__exportStar(require("./MultiFileRunPackage"), exports);
+__exportStar(require("./MultiFileRunPackageFilesItem"), exports);
 __exportStar(require("./NextPageToken"), exports);
 __exportStar(require("./PageRanges"), exports);
 __exportStar(require("./PageRangesItem"), exports);
@@ -322,6 +324,9 @@ __exportStar(require("./ParseRunSource"), exports);
 __exportStar(require("./ParseRunStatus"), exports);
 __exportStar(require("./ParseRunStatusEnum"), exports);
 __exportStar(require("./ParseRunStatusStatus"), exports);
+__exportStar(require("./ParseRunSummary"), exports);
+__exportStar(require("./ParseRunSummaryMetrics"), exports);
+__exportStar(require("./ParseRunSummaryStatus"), exports);
 __exportStar(require("./ParseStepDefinition"), exports);
 __exportStar(require("./ParseStepDefinitionConfig"), exports);
 __exportStar(require("./ParseStepRun"), exports);
@@ -351,6 +356,7 @@ __exportStar(require("./RunSecrets"), exports);
 __exportStar(require("./RunSource"), exports);
 __exportStar(require("./RunSourceId"), exports);
 __exportStar(require("./RunUsage"), exports);
+__exportStar(require("./RunUsageBreakdownCharge"), exports);
 __exportStar(require("./RunUsageBreakdownEntry"), exports);
 __exportStar(require("./RunUsageBreakdownEntryObject"), exports);
 __exportStar(require("./RunUsageSummary"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "extend-ai",
-    "version": "1.13.0",
+    "version": "1.15.0",
     "private": false,
     "repository": {
         "type": "git",

package/reference.md

@@ -168,7 +168,9 @@ Extract structured data from a file synchronously, waiting for the result before
 
 **Note:** This endpoint is intended for onboarding and testing only. For production workloads, use `POST /extract_runs` with [polling or webhooks](https://docs.extend.ai/2026-02-09/general/async-processing) instead, as it provides better reliability for large files and avoids timeout issues.
 
-The Extract endpoint allows you to extract structured data from files using an existing extractor or an inline configuration.
+The Extract endpoint allows you to extract structured data from files using an existing extractor, an inline configuration, or no configuration at all. When neither is provided, Extend automatically infers a schema from the document before extraction — no extractor or schema is required.
+
+Pass `file` for a single document, or `package` to extract from multiple files in a single run. Exactly one of `file` or `package` must be provided.
 
 For more details, see the [Extract File guide](https://docs.extend.ai/2026-02-09/extraction/overview).
 </dd>
@@ -1028,6 +1030,83 @@ Example: `"pr_xK9mLPqRtN3vS8wF5hB2cQ"`
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.parseRuns.<a href="/src/api/resources/parseRuns/client/Client.ts">cancel</a>(id, { ...params }) -> Extend.ParseRun</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Cancel an in-progress parse run.
+
+Note: Only parse runs with a status of `"PROCESSING"` can be cancelled. Parse runs that have already completed, failed, or been cancelled cannot be cancelled again.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.parseRuns.cancel("parse_run_id_here");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**id:** `string` 
+
+The ID of the parse run to cancel.
+
+Example: `"pr_xK9mLPqRtN3vS8wF5hB2cQ"`
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `Extend.ParseRunsCancelRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ParseRunsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -5567,7 +5646,7 @@ Unlike the single [Run Workflow](https://docs.extend.ai/2026-02-09/api-reference
 
 Our recommended usage pattern is to integrate with [Webhooks](https://docs.extend.ai/2026-02-09/webhooks/configuration) for consuming results, using the `metadata` and `batchId` to match up results to the original inputs in your downstream systems. However, you can integrate in a polling mechanism by using a combination of the [List Workflow Runs](https://docs.extend.ai/2026-02-09/api-reference/endpoints/workflow/list-workflow-runs) endpoint to fetch all runs via a batch, and then [Get Workflow Run](https://docs.extend.ai/2026-02-09/api-reference/endpoints/workflow/get-workflow-run) to fetch the full outputs each run.
 
-**Priority:** All workflow runs created through this batch endpoint are automatically assigned a priority of 90.
+**Priority:** By default, workflow runs created through this batch endpoint are assigned a priority of 90. You can override this by passing an optional `priority` value (1–100) in the request body — lower values run first.
 
 **Processing and Monitoring:**
 Upon successful submission, the endpoint returns a `batchId`. The individual workflow runs are then queued for processing.

package/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.13.0";
+export declare const SDK_VERSION = "1.15.0";

package/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.13.0";
+exports.SDK_VERSION = "1.15.0";

package/wrapper/resources/extractRuns/ExtractRunsWrapper.test.js

@@ -51,7 +51,7 @@ function createMockExtractRun(overrides = {}) {
             metadata: {},
             createdAt: "2024-01-01T00:00:00Z",
             updatedAt: "2024-01-01T00:00:00Z",
-        }, dashboardUrl: "https://dashboard.extend.ai/extract-runs/extract_run_test123", edits: {}, usage: { credits: 1 }, failureReason: null, failureMessage: null, parseRunId: null, createdAt: "2024-01-01T00:00:00Z", updatedAt: "2024-01-01T00:00:00Z" }, overrides);
+        }, files: null, dashboardUrl: "https://dashboard.extend.ai/extract-runs/extract_run_test123", edits: {}, usage: { credits: 1 }, failureReason: null, failureMessage: null, parseRunId: null, createdAt: "2024-01-01T00:00:00Z", updatedAt: "2024-01-01T00:00:00Z" }, overrides);
 }
 // ============================================================================
 // Tests

package/wrapper/resources/parseRuns/ParseRunsWrapper.test.js

@@ -34,7 +34,7 @@ function createMockParseRun(overrides = {}) {
             metadata: {},
             createdAt: "2024-01-01T00:00:00Z",
             updatedAt: "2024-01-01T00:00:00Z",
-        }, failureReason: null, failureMessage: null, output: null, outputUrl: null, metrics: null, usage: null }, overrides);
+        }, failureReason: null, failureMessage: null, metadata: null, output: null, outputUrl: null, metrics: null, usage: null }, overrides);
 }
 // ============================================================================
 // Tests

package/wrapper/webhooks/Webhooks.test.js

@@ -145,6 +145,7 @@ const sampleExtractRunPayload = {
         createdAt: "2024-01-01T00:00:00Z",
         updatedAt: "2024-01-01T00:00:00Z",
     },
+    files: null,
     dashboardUrl: "https://dashboard.extend.ai/extract-runs/extract_run_def456",
     edits: {},
     usage: { credits: 1 },