extend-ai 1.10.0 → 1.11.0

package/.gitattributes

@@ -0,0 +1 @@
+.fern/replay.lock linguist-generated=true

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.10.0",
-        "User-Agent": "extend-ai/1.10.0",
+        "X-Fern-SDK-Version": "1.11.0",
+        "User-Agent": "extend-ai/1.11.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/api/resources/evaluationSetRuns/client/Client.d.ts

@@ -10,6 +10,40 @@ export declare namespace EvaluationSetRunsClient {
 export declare class EvaluationSetRunsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<EvaluationSetRunsClient.Options>;
     constructor(options: EvaluationSetRunsClient.Options);
+    /**
+     * Create and start an async evaluation set run. The response returns the evaluation set run object with its initial status; use `GET /evaluation_set_runs/{id}` to poll for completion.
+     *
+     * Evaluation set runs are currently supported for document processor evaluation sets.
+     *
+     * @param {Extend.EvaluationSetRunsCreateRequest} request
+     * @param {EvaluationSetRunsClient.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.evaluationSetRuns.create({
+     *         evaluationSetId: "ev_2LcgeY_mp2T5yPaEuq5Lw",
+     *         entity: {
+     *             id: "ex_Xj8mK2pL9nR4vT7qY5wZ",
+     *             version: "1.0"
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.evaluationSetRuns.create({
+     *         evaluationSetId: "ev_2LcgeY_mp2T5yPaEuq5Lw",
+     *         evaluationSetItemIds: ["evi_kR9mNP12Qw4yTv8BdR3H"]
+     *     })
+     */
+    create(request: Extend.EvaluationSetRunsCreateRequest, requestOptions?: EvaluationSetRunsClient.RequestOptions): core.HttpResponsePromise<Extend.EvaluationSetRun>;
+    private __create;
     /**
      * Get details of an evaluation set run.
      *

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

@@ -42,6 +42,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EvaluationSetRunsClient = void 0;
 const BaseClient_1 = require("../../../../BaseClient");
@@ -55,6 +66,96 @@ class EvaluationSetRunsClient {
     constructor(options) {
         this._options = (0, BaseClient_1.normalizeClientOptionsWithAuth)(options);
     }
+    /**
+     * Create and start an async evaluation set run. The response returns the evaluation set run object with its initial status; use `GET /evaluation_set_runs/{id}` to poll for completion.
+     *
+     * Evaluation set runs are currently supported for document processor evaluation sets.
+     *
+     * @param {Extend.EvaluationSetRunsCreateRequest} request
+     * @param {EvaluationSetRunsClient.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.evaluationSetRuns.create({
+     *         evaluationSetId: "ev_2LcgeY_mp2T5yPaEuq5Lw",
+     *         entity: {
+     *             id: "ex_Xj8mK2pL9nR4vT7qY5wZ",
+     *             version: "1.0"
+     *         }
+     *     })
+     *
+     * @example
+     *     await client.evaluationSetRuns.create({
+     *         evaluationSetId: "ev_2LcgeY_mp2T5yPaEuq5Lw",
+     *         evaluationSetItemIds: ["evi_kR9mNP12Qw4yTv8BdR3H"]
+     *     })
+     */
+    create(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
+    }
+    __create(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+            const { "x-extend-workspace-id": extendWorkspaceId } = request, _body = __rest(request, ["x-extend-workspace-id"]);
+            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, "evaluation_set_runs"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                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", "/evaluation_set_runs");
+        });
+    }
     /**
      * Get details of an evaluation set run.
      *

package/api/resources/evaluationSetRuns/client/requests/EvaluationSetRunsCreateRequest.d.ts

@@ -0,0 +1,27 @@
+import type * as Extend from "../../../../index";
+/**
+ * @example
+ *     {
+ *         evaluationSetId: "ev_2LcgeY_mp2T5yPaEuq5Lw",
+ *         entity: {
+ *             id: "ex_Xj8mK2pL9nR4vT7qY5wZ",
+ *             version: "1.0"
+ *         }
+ *     }
+ *
+ * @example
+ *     {
+ *         evaluationSetId: "ev_2LcgeY_mp2T5yPaEuq5Lw",
+ *         evaluationSetItemIds: ["evi_kR9mNP12Qw4yTv8BdR3H"]
+ *     }
+ */
+export interface EvaluationSetRunsCreateRequest {
+    /** 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/developers/authentication) for details on API key scopes. */
+    "x-extend-workspace-id"?: string;
+    /** The ID of the evaluation set to run. */
+    evaluationSetId: string;
+    /** Optional processor and version to run against the evaluation set. If omitted, the evaluation set's processor is run at its draft version. */
+    entity?: Extend.EvaluationSetRunsCreateRequestEntity;
+    /** Optional list of evaluation set item IDs to run. If omitted, all items in the evaluation set are run. */
+    evaluationSetItemIds?: string[];
+}

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

@@ -1 +1,2 @@
+export type { EvaluationSetRunsCreateRequest } from "./EvaluationSetRunsCreateRequest";
 export type { EvaluationSetRunsRetrieveRequest } from "./EvaluationSetRunsRetrieveRequest";

package/api/resources/evaluationSetRuns/index.d.ts

@@ -1 +1,2 @@
 export * from "./client";
+export * from "./types";

package/api/resources/evaluationSetRuns/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client"), exports);
+__exportStar(require("./types"), exports);

package/api/resources/evaluationSetRuns/types/EvaluationSetRunsCreateRequestEntity.d.ts

@@ -0,0 +1,9 @@
+import type * as Extend from "../../../index";
+/**
+ * Optional processor and version to run against the evaluation set. If omitted, the evaluation set's processor is run at its draft version.
+ */
+export interface EvaluationSetRunsCreateRequestEntity {
+    /** The ID of the extractor, classifier, or splitter to evaluate. */
+    id: string;
+    version?: Extend.ProcessorVersionString;
+}

package/api/resources/evaluationSetRuns/types/EvaluationSetRunsCreateRequestEntity.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/evaluationSetRuns/types/index.d.ts

@@ -0,0 +1 @@
+export * from "./EvaluationSetRunsCreateRequestEntity";

package/api/resources/evaluationSetRuns/types/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./EvaluationSetRunsCreateRequestEntity"), exports);

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

@@ -37,6 +37,8 @@ export declare class ExtractorsClient {
     /**
      * Create a new extractor.
      *
+     * You can optionally provide a `generate` object to automatically generate an extraction schema from sample documents using AI. `generate` is mutually exclusive with `config` and `cloneExtractorId`.
+     *
      * @param {Extend.ExtractorsCreateRequest} request
      * @param {ExtractorsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -57,21 +59,41 @@ export declare class ExtractorsClient {
      *                 "type": "object",
      *                 "properties": {
      *                     "vendor_name": {
-     *                         "type": "string",
+     *                         "type": [
+     *                             "string",
+     *                             "null"
+     *                         ],
      *                         "description": "The name of the vendor"
      *                     },
      *                     "invoice_number": {
-     *                         "type": "string",
+     *                         "type": [
+     *                             "string",
+     *                             "null"
+     *                         ],
      *                         "description": "The invoice number"
      *                     },
      *                     "total_amount": {
-     *                         "type": "number",
+     *                         "type": [
+     *                             "number",
+     *                             "null"
+     *                         ],
      *                         "description": "The total amount due"
      *                     }
      *                 }
      *             }
      *         }
      *     })
+     *
+     * @example
+     *     await client.extractors.create({
+     *         name: "Invoice Extractor",
+     *         generate: {
+     *             files: [{
+     *                     url: "https://example.com/sample-invoice.pdf"
+     *                 }],
+     *             instructions: "US tax invoice with line items, vendor details, and total amount"
+     *         }
+     *     })
      */
     create(request: Extend.ExtractorsCreateRequest, requestOptions?: ExtractorsClient.RequestOptions): core.HttpResponsePromise<Extend.Extractor>;
     private __create;

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

@@ -152,6 +152,8 @@ class ExtractorsClient {
     /**
      * Create a new extractor.
      *
+     * You can optionally provide a `generate` object to automatically generate an extraction schema from sample documents using AI. `generate` is mutually exclusive with `config` and `cloneExtractorId`.
+     *
      * @param {Extend.ExtractorsCreateRequest} request
      * @param {ExtractorsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
@@ -172,21 +174,41 @@ class ExtractorsClient {
      *                 "type": "object",
      *                 "properties": {
      *                     "vendor_name": {
-     *                         "type": "string",
+     *                         "type": [
+     *                             "string",
+     *                             "null"
+     *                         ],
      *                         "description": "The name of the vendor"
      *                     },
      *                     "invoice_number": {
-     *                         "type": "string",
+     *                         "type": [
+     *                             "string",
+     *                             "null"
+     *                         ],
      *                         "description": "The invoice number"
      *                     },
      *                     "total_amount": {
-     *                         "type": "number",
+     *                         "type": [
+     *                             "number",
+     *                             "null"
+     *                         ],
      *                         "description": "The total amount due"
      *                     }
      *                 }
      *             }
      *         }
      *     })
+     *
+     * @example
+     *     await client.extractors.create({
+     *         name: "Invoice Extractor",
+     *         generate: {
+     *             files: [{
+     *                     url: "https://example.com/sample-invoice.pdf"
+     *                 }],
+     *             instructions: "US tax invoice with line items, vendor details, and total amount"
+     *         }
+     *     })
      */
     create(request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));

package/api/resources/extractors/client/requests/ExtractorsCreateRequest.d.ts

@@ -8,31 +8,57 @@ import type * as Extend from "../../../../index";
  *                 "type": "object",
  *                 "properties": {
  *                     "vendor_name": {
- *                         "type": "string",
+ *                         "type": [
+ *                             "string",
+ *                             "null"
+ *                         ],
  *                         "description": "The name of the vendor"
  *                     },
  *                     "invoice_number": {
- *                         "type": "string",
+ *                         "type": [
+ *                             "string",
+ *                             "null"
+ *                         ],
  *                         "description": "The invoice number"
  *                     },
  *                     "total_amount": {
- *                         "type": "number",
+ *                         "type": [
+ *                             "number",
+ *                             "null"
+ *                         ],
  *                         "description": "The total amount due"
  *                     }
  *                 }
  *             }
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         name: "Invoice Extractor",
+ *         generate: {
+ *             files: [{
+ *                     url: "https://example.com/sample-invoice.pdf"
+ *                 }],
+ *             instructions: "US tax invoice with line items, vendor details, and total amount"
+ *         }
+ *     }
  */
 export interface ExtractorsCreateRequest {
     /** The name of the extractor. */
     name: string;
     /**
-     * The ID of an existing extractor to clone. If provided, the new extractor will be created with the same config as the extractor with this ID. Cannot be provided together with `config`.
+     * The ID of an existing extractor to clone. If provided, the new extractor will be created with the same config as the extractor with this ID. Cannot be provided together with `config` or `generate`.
      *
      * Example: `"ex_BMdfq_yWM3sT-ZzvCnA3f"`
      */
     cloneExtractorId?: string;
-    /** The configuration for the extractor. Cannot be provided together with `cloneExtractorId`. */
+    /** The configuration for the extractor. Cannot be provided together with `cloneExtractorId` or `generate`. */
     config?: Extend.ExtractConfigJson;
+    /**
+     * If provided, an extraction schema is automatically generated from the supplied sample documents and applied to the extractor's draft. The response includes the extractor with the generated schema already in place.
+     *
+     * Cannot be provided together with `config` or `cloneExtractorId`.
+     */
+    generate?: Extend.ExtractorsCreateRequestGenerate;
 }

package/api/resources/extractors/types/ExtractorsCreateRequestGenerate.d.ts

@@ -0,0 +1,12 @@
+import type * as Extend from "../../../index";
+/**
+ * If provided, an extraction schema is automatically generated from the supplied sample documents and applied to the extractor's draft. The response includes the extractor with the generated schema already in place.
+ *
+ * Cannot be provided together with `config` or `cloneExtractorId`.
+ */
+export interface ExtractorsCreateRequestGenerate {
+    /** One to five sample documents used to generate the schema. Each item is either a file URL (downloaded inline) or an existing Extend file ID. */
+    files: Extend.ExtractorsCreateRequestGenerateFilesItem[];
+    /** Optional, but recommended. Describe the type of document, kinds of fields you want to extract, key requirements, and rules to follow. More context is better. */
+    instructions?: string;
+}

package/api/resources/extractors/types/ExtractorsCreateRequestGenerate.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/extractors/types/ExtractorsCreateRequestGenerateFilesItem.d.ts

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

package/api/resources/extractors/types/ExtractorsCreateRequestGenerateFilesItem.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/extractors/types/index.d.ts

@@ -1 +1,3 @@
+export * from "./ExtractorsCreateRequestGenerate";
+export * from "./ExtractorsCreateRequestGenerateFilesItem";
 export * from "./ExtractorsListResponse";

package/api/resources/extractors/types/index.js

@@ -14,4 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ExtractorsCreateRequestGenerate"), exports);
+__exportStar(require("./ExtractorsCreateRequestGenerateFilesItem"), exports);
 __exportStar(require("./ExtractorsListResponse"), exports);

package/api/resources/index.d.ts

@@ -24,6 +24,7 @@ export * from "./evaluationSetItems/client/requests";
 export * from "./evaluationSetItems/types";
 export * as evaluationSetRuns from "./evaluationSetRuns";
 export * from "./evaluationSetRuns/client/requests";
+export * from "./evaluationSetRuns/types";
 export * as evaluationSets from "./evaluationSets";
 export * from "./evaluationSets/client/requests";
 export * from "./evaluationSets/types";

package/api/resources/index.js

@@ -63,6 +63,7 @@ __exportStar(require("./evaluationSetItems/client/requests"), exports);
 __exportStar(require("./evaluationSetItems/types"), exports);
 exports.evaluationSetRuns = __importStar(require("./evaluationSetRuns"));
 __exportStar(require("./evaluationSetRuns/client/requests"), exports);
+__exportStar(require("./evaluationSetRuns/types"), exports);
 exports.evaluationSets = __importStar(require("./evaluationSets"));
 __exportStar(require("./evaluationSets/client/requests"), exports);
 __exportStar(require("./evaluationSets/types"), exports);

package/api/types/ClassifyAdvancedOptions.d.ts

@@ -4,5 +4,7 @@ export interface ClassifyAdvancedOptions {
     context?: Extend.ClassifyAdvancedOptionsContext;
     /** Enable advanced multimodal processing for better handling of visual elements during classification. */
     advancedMultimodalEnabled?: boolean;
+    /** Enable memory for enhanced processing by learning from past successful classifications. */
+    memoryEnabled?: boolean;
     pageRanges?: Extend.PageRanges;
 }

package/api/types/ClassifyRun.d.ts

@@ -11,6 +11,13 @@ export interface ClassifyRun {
      * Example: `"clr_Xj8mK2pL9nR4vT7qY5wZ"`
      */
     id: string;
+    status: Extend.ProcessorRunStatus;
+    /**
+     * The final output, either reviewed or initial.
+     *
+     * **Availability:** Present when `status` is `"PROCESSED"`.
+     */
+    output: Extend.ClassifyOutput | null;
     /**
      * The classifier that was used for this run.
      *
@@ -23,13 +30,6 @@ export interface ClassifyRun {
      * **Availability:** Present when a classifier reference was provided. Not present when using inline `config`.
      */
     classifierVersion: Extend.ClassifierVersionSummary | null;
-    status: Extend.ProcessorRunStatus;
-    /**
-     * The final output, either reviewed or initial.
-     *
-     * **Availability:** Present when `status` is `"PROCESSED"`.
-     */
-    output: Extend.ClassifyOutput | null;
     /**
      * The initial output from the classify run, before any review edits.
      *

package/api/types/ExtractAdvancedOptions.d.ts

@@ -6,8 +6,13 @@ export interface ExtractAdvancedOptions {
     advancedMultimodalEnabled?: boolean;
     /** Whether to enable citations in the output. */
     citationsEnabled?: boolean;
-    /** Whether to include the current date as context for the model during extraction. Defaults to `false`. */
-    currentDateEnabled?: boolean;
+    /**
+     * Controls the granularity of citations returned alongside extracted values. Requires `citationsEnabled=true` and a base processor version that supports bounding box citations.
+     * - `line`: Use OCR lines for citations. This can return one or more relevant OCR lines for each citation. This is the default mode.
+     * - `word`: Narrow each matched citation down to the relevant OCR word span when possible. Note: this might still return line citations in cases where the citation model is unable to reliably narrow down to a word-level citation. Typically, this only makes sense when you are doing array extraction and want precise word citations from a given cell in a table to match an array property, e.g. `line_items.total`.
+     * - `block`: Use parser blocks (e.g. full paragraphs, key-val regions, tables, lists, etc.) and return block-level polygons for each citation. Will have highest recall in terms of overlap with the extracted value source, but least granularity.
+     */
+    citationMode?: Extend.ExtractAdvancedOptionsCitationMode;
     /** Granularity for array citations. This requires citationsEnabled=true and a base processor version that supports property-level array citations (extraction_performance ≥ 4.4.0). */
     arrayCitationStrategy?: Extend.ExtractAdvancedOptionsArrayCitationStrategy;
     /** Strategy for handling large arrays in documents. */
@@ -27,4 +32,6 @@ export interface ExtractAdvancedOptions {
      * To learn more, view the [Review Agent Documentation](https://docs.extend.ai/2026-02-09/product/extraction/review-agent)
      */
     reviewAgent?: Extend.ExtractAdvancedOptionsReviewAgent;
+    /** Whether to include the current date as context for the model during extraction. Defaults to `false`. */
+    currentDateEnabled?: boolean;
 }

package/api/types/ExtractAdvancedOptionsCitationMode.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Controls the granularity of citations returned alongside extracted values. Requires `citationsEnabled=true` and a base processor version that supports bounding box citations.
+ * - `line`: Use OCR lines for citations. This can return one or more relevant OCR lines for each citation. This is the default mode.
+ * - `word`: Narrow each matched citation down to the relevant OCR word span when possible. Note: this might still return line citations in cases where the citation model is unable to reliably narrow down to a word-level citation. Typically, this only makes sense when you are doing array extraction and want precise word citations from a given cell in a table to match an array property, e.g. `line_items.total`.
+ * - `block`: Use parser blocks (e.g. full paragraphs, key-val regions, tables, lists, etc.) and return block-level polygons for each citation. Will have highest recall in terms of overlap with the extracted value source, but least granularity.
+ */
+export declare const ExtractAdvancedOptionsCitationMode: {
+    readonly Line: "line";
+    readonly Word: "word";
+    readonly Block: "block";
+};
+export type ExtractAdvancedOptionsCitationMode = (typeof ExtractAdvancedOptionsCitationMode)[keyof typeof ExtractAdvancedOptionsCitationMode] | string;

package/api/types/ExtractAdvancedOptionsCitationMode.js

@@ -0,0 +1,15 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtractAdvancedOptionsCitationMode = void 0;
+/**
+ * Controls the granularity of citations returned alongside extracted values. Requires `citationsEnabled=true` and a base processor version that supports bounding box citations.
+ * - `line`: Use OCR lines for citations. This can return one or more relevant OCR lines for each citation. This is the default mode.
+ * - `word`: Narrow each matched citation down to the relevant OCR word span when possible. Note: this might still return line citations in cases where the citation model is unable to reliably narrow down to a word-level citation. Typically, this only makes sense when you are doing array extraction and want precise word citations from a given cell in a table to match an array property, e.g. `line_items.total`.
+ * - `block`: Use parser blocks (e.g. full paragraphs, key-val regions, tables, lists, etc.) and return block-level polygons for each citation. Will have highest recall in terms of overlap with the extracted value source, but least granularity.
+ */
+exports.ExtractAdvancedOptionsCitationMode = {
+    Line: "line",
+    Word: "word",
+    Block: "block",
+};

package/api/types/ExtractRun.d.ts

@@ -11,18 +11,6 @@ export interface ExtractRun {
      * Example: `"exr_Xj8mK2pL9nR4vT7qY5wZ"`
      */
     id: string;
-    /**
-     * The extractor that was used for this run.
-     *
-     * **Availability:** Present when an extractor reference was provided. Not present when using inline `config`.
-     */
-    extractor: Extend.ExtractorSummary | null;
-    /**
-     * The version of the extractor that was used for this run.
-     *
-     * **Availability:** Present when an extractor reference was provided. Not present when using inline `config`.
-     */
-    extractorVersion: Extend.ExtractorVersionSummary | null;
     status: Extend.ProcessorRunStatus;
     /**
      * The final output, either reviewed or initial. This is a union of two possible shapes:
@@ -93,6 +81,18 @@ export interface ExtractRun {
      * - **[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;
+    /**
+     * The extractor that was used for this run.
+     *
+     * **Availability:** Present when an extractor reference was provided. Not present when using inline `config`.
+     */
+    extractor: Extend.ExtractorSummary | null;
+    /**
+     * The version of the extractor that was used for this run.
+     *
+     * **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;
     /**

package/api/types/SplitRun.d.ts

@@ -11,6 +11,13 @@ export interface SplitRun {
      * Example: `"splr_Xj8mK2pL9nR4vT7qY5wZ"`
      */
     id: string;
+    status: Extend.ProcessorRunStatus;
+    /**
+     * The final output, either reviewed or initial.
+     *
+     * **Availability:** Present when `status` is `"PROCESSED"`.
+     */
+    output: Extend.SplitOutput | null;
     /**
      * The splitter that was used for this run.
      *
@@ -23,13 +30,6 @@ export interface SplitRun {
      * **Availability:** Present when a splitter reference was provided. Not present when using inline `config`.
      */
     splitterVersion: Extend.SplitterVersionSummary | null;
-    status: Extend.ProcessorRunStatus;
-    /**
-     * The final output, either reviewed or initial.
-     *
-     * **Availability:** Present when `status` is `"PROCESSED"`.
-     */
-    output: Extend.SplitOutput | null;
     /**
      * The initial output from the split run, before any review edits.
      *

package/api/types/StepRun.d.ts

@@ -1,5 +1,31 @@
 import type * as Extend from "../index";
 /**
- * A workflow step run. The shape of the `result` field depends on the `step.type`.
+ * A workflow step run. The shape of the `result` field depends on the `stepType`.
  */
-export type StepRun = Extend.ParseStepRun | Extend.ExtractStepRun | Extend.ClassifyStepRun | Extend.SplitStepRun | Extend.MergeExtractStepRun | Extend.ConditionalExtractStepRun | Extend.RuleValidationStepRun | Extend.ExternalDataValidationStepRun;
+export type StepRun = Extend.StepRun.Parse | Extend.StepRun.Extract | Extend.StepRun.Classify | Extend.StepRun.Split | Extend.StepRun.MergeExtract | Extend.StepRun.ConditionalExtract | Extend.StepRun.RuleValidation | Extend.StepRun.ExternalDataValidation;
+export declare namespace StepRun {
+    interface Parse extends Extend.ParseStepRun {
+        stepType: "PARSE";
+    }
+    interface Extract extends Extend.ExtractStepRun {
+        stepType: "EXTRACT";
+    }
+    interface Classify extends Extend.ClassifyStepRun {
+        stepType: "CLASSIFY";
+    }
+    interface Split extends Extend.SplitStepRun {
+        stepType: "SPLIT";
+    }
+    interface MergeExtract extends Extend.MergeExtractStepRun {
+        stepType: "MERGE_EXTRACT";
+    }
+    interface ConditionalExtract extends Extend.ConditionalExtractStepRun {
+        stepType: "CONDITIONAL_EXTRACT";
+    }
+    interface RuleValidation extends Extend.RuleValidationStepRun {
+        stepType: "RULE_VALIDATION";
+    }
+    interface ExternalDataValidation extends Extend.ExternalDataValidationStepRun {
+        stepType: "EXTERNAL_DATA_VALIDATION";
+    }
+}

package/api/types/index.d.ts

@@ -119,6 +119,7 @@ export * from "./ExternalDataValidationStepRun";
 export * from "./ExternalDataValidationStepRunStep";
 export * from "./ExtractAdvancedOptions";
 export * from "./ExtractAdvancedOptionsArrayCitationStrategy";
+export * from "./ExtractAdvancedOptionsCitationMode";
 export * from "./ExtractAdvancedOptionsExcelSheetSelectionStrategy";
 export * from "./ExtractAdvancedOptionsReviewAgent";
 export * from "./ExtractBaseProcessor";

package/api/types/index.js

@@ -135,6 +135,7 @@ __exportStar(require("./ExternalDataValidationStepRun"), exports);
 __exportStar(require("./ExternalDataValidationStepRunStep"), exports);
 __exportStar(require("./ExtractAdvancedOptions"), exports);
 __exportStar(require("./ExtractAdvancedOptionsArrayCitationStrategy"), exports);
+__exportStar(require("./ExtractAdvancedOptionsCitationMode"), exports);
 __exportStar(require("./ExtractAdvancedOptionsExcelSheetSelectionStrategy"), exports);
 __exportStar(require("./ExtractAdvancedOptionsReviewAgent"), exports);
 __exportStar(require("./ExtractBaseProcessor"), exports);

package/package.json

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

package/reference.md

@@ -2047,6 +2047,8 @@ await client.extractors.list({
 <dd>
 
 Create a new extractor.
+
+You can optionally provide a `generate` object to automatically generate an extraction schema from sample documents using AI. `generate` is mutually exclusive with `config` and `cloneExtractorId`.
 </dd>
 </dl>
 </dd>
@@ -2068,15 +2070,24 @@ await client.extractors.create({
             "type": "object",
             "properties": {
                 "vendor_name": {
-                    "type": "string",
+                    "type": [
+                        "string",
+                        "null"
+                    ],
                     "description": "The name of the vendor"
                 },
                 "invoice_number": {
-                    "type": "string",
+                    "type": [
+                        "string",
+                        "null"
+                    ],
                     "description": "The invoice number"
                 },
                 "total_amount": {
-                    "type": "number",
+                    "type": [
+                        "number",
+                        "null"
+                    ],
                     "description": "The total amount due"
                 }
             }
@@ -7230,6 +7241,77 @@ Example: `"evi_kR9mNP12Qw4yTv8BdR3H"`
 </details>
 
 ## EvaluationSetRuns
+<details><summary><code>client.evaluationSetRuns.<a href="/src/api/resources/evaluationSetRuns/client/Client.ts">create</a>({ ...params }) -> Extend.EvaluationSetRun</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Create and start an async evaluation set run. The response returns the evaluation set run object with its initial status; use `GET /evaluation_set_runs/{id}` to poll for completion.
+
+Evaluation set runs are currently supported for document processor evaluation sets.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.evaluationSetRuns.create({
+    evaluationSetId: "ev_2LcgeY_mp2T5yPaEuq5Lw",
+    entity: {
+        id: "ex_Xj8mK2pL9nR4vT7qY5wZ",
+        version: "1.0"
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `Extend.EvaluationSetRunsCreateRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `EvaluationSetRunsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
 <details><summary><code>client.evaluationSetRuns.<a href="/src/api/resources/evaluationSetRuns/client/Client.ts">retrieve</a>(id, { ...params }) -> Extend.EvaluationSetRun</code></summary>
 <dl>
 <dd>

package/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.10.0";
+export declare const SDK_VERSION = "1.11.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.10.0";
+exports.SDK_VERSION = "1.11.0";