extend-ai 1.11.0 → 1.14.0

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/RunUsageSummary.d.ts

@@ -5,7 +5,7 @@
  * * Runs created before October 7, 2025
  * * Customers on legacy billing systems
  *
- * For more details on how credits work, see our [Credits Guide](https://docs.extend.ai/2026-02-09/product/general/how-credits-work).
+ * For more details on how credits work, see our [Credits Guide](https://docs.extend.ai/2026-02-09/general/how-credits-work).
  */
 export interface RunUsageSummary {
     /** The credits consumed by this run. For most run types this is the line item for the run's own work; for `workflow_run` this is the aggregate across all child runs. */

package/api/types/SplitBaseProcessor.d.ts

@@ -1,4 +1,4 @@
-/** The base processor to use. For splitters, this can be either `"splitting_performance"` or `"splitting_light"`. Defaults to `"splitting_performance"` if not provided. See [Splitting Changelog](https://docs.extend.ai/2026-02-09/changelog/splitting/splitting-performance) for more details. */
+/** The base processor to use. For splitters, this can be either `"splitting_performance"` or `"splitting_light"`. Defaults to `"splitting_performance"` if not provided. See [Splitting Changelog](https://docs.extend.ai/2026-02-09/model-versioning/splitting/splitting-performance) for more details. */
 export declare const SplitBaseProcessor: {
     readonly SplittingPerformance: "splitting_performance";
     readonly SplittingLight: "splitting_light";

package/api/types/SplitBaseProcessor.js

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

package/api/types/SplitConfig.d.ts

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

package/api/types/SplitOverrideConfig.d.ts

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

package/api/types/SplitRun.d.ts

@@ -79,8 +79,8 @@ export interface SplitRun {
     edited: boolean;
     /** The configuration used for this split run. */
     config: Extend.SplitConfig;
-    /** 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 split run.
      *

package/api/types/SplitRunSummary.d.ts

@@ -42,8 +42,8 @@ export interface SplitRunSummary {
     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 split run.
      *

package/api/types/SplitStepDefinition.d.ts

@@ -4,7 +4,7 @@ import type * as Extend from "../index";
  *
  * The splitter reference must include a pinned `version` — `"latest"` is not supported for `SPLIT` 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 [Split step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#split-step).
+ * See the [Split step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#split).
  */
 export interface SplitStepDefinition {
     name: string;
@@ -15,13 +15,13 @@ export interface SplitStepDefinition {
      *
      * The splitter `version` is required and must be a pinned version (semver like `"0.1"` or `"draft"`). `"latest"` is not allowed.
      *
-     * See the [Split step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#split-step).
+     * See the [Split step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#split).
      */
     config?: Extend.SplitStepDefinitionConfig;
     /**
      * Can only be set when `config` is present. Each entry must include a `classificationId` matching a split classification `id` from the referenced splitter's configuration. Use the classification's stable `id` (e.g. `"cls_receipt"`), not the `type` string.
      *
-     * See the [Split step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#split-step).
+     * See the [Split step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#split).
      */
     next?: Extend.ClassificationNextEntry[];
 }

package/api/types/SplitStepDefinitionConfig.d.ts

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

package/api/types/TriggerStepDefinition.d.ts

@@ -2,7 +2,7 @@ import type * as Extend from "../index";
 /**
  * The entry point of the workflow. Every workflow must have exactly one trigger step, and it must route to exactly one `PARSE` step.
  *
- * See the [Trigger step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#trigger-step).
+ * See the [Trigger step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#trigger).
  */
 export interface TriggerStepDefinition {
     /** Unique name for this step. */

package/api/types/WebhookResponseStepDefinition.d.ts

@@ -1,7 +1,7 @@
 /**
  * A terminal step that triggers webhook delivery of the workflow results.
  *
- * See the [Webhook Response step docs](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api#webhook-response-step).
+ * See the [Webhook Response step docs](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows#webhook-response).
  */
 export interface WebhookResponseStepDefinition {
     name: string;

package/api/types/WorkflowStepDefinition.d.ts

@@ -2,7 +2,7 @@ import type * as Extend from "../index";
 /**
  * A workflow step definition used when creating, updating, deploying, and retrieving workflow versions.
  *
- * See the [Configuring Workflows via API guide](https://docs.extend.ai/2026-02-09/product/workflows/configuring-workflows-via-api) for routing patterns and examples.
+ * See the [Configuring Workflows via API guide](https://docs.extend.ai/2026-02-09/workflows/configuring-workflows) for routing patterns and examples.
  */
 export type WorkflowStepDefinition = Extend.WorkflowStepDefinition.Trigger | Extend.WorkflowStepDefinition.Parse | Extend.WorkflowStepDefinition.Extract | Extend.WorkflowStepDefinition.Classify | Extend.WorkflowStepDefinition.Split | Extend.WorkflowStepDefinition.MergeExtract | Extend.WorkflowStepDefinition.Conditional | Extend.WorkflowStepDefinition.ConditionalExtract | Extend.WorkflowStepDefinition.ExternalDataValidation | Extend.WorkflowStepDefinition.WebhookResponse | Extend.WorkflowStepDefinition.RuleValidation | Extend.WorkflowStepDefinition.HumanReview | Extend.WorkflowStepDefinition.Collect | Extend.WorkflowStepDefinition.FileConversion;
 export declare namespace WorkflowStepDefinition {

package/api/types/index.d.ts

@@ -13,6 +13,7 @@ export * from "./Block";
 export * from "./BlockDetails";
 export * from "./BlockMetadata";
 export * from "./BlockMetadataPage";
+export * from "./BlockMetadataSheet";
 export * from "./BlockMetadataTextDirection";
 export * from "./BlockPolygonItem";
 export * from "./BlockType";
@@ -305,6 +306,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";
@@ -334,6 +338,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

@@ -29,6 +29,7 @@ __exportStar(require("./Block"), exports);
 __exportStar(require("./BlockDetails"), exports);
 __exportStar(require("./BlockMetadata"), exports);
 __exportStar(require("./BlockMetadataPage"), exports);
+__exportStar(require("./BlockMetadataSheet"), exports);
 __exportStar(require("./BlockMetadataTextDirection"), exports);
 __exportStar(require("./BlockPolygonItem"), exports);
 __exportStar(require("./BlockType"), exports);
@@ -321,6 +322,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);
@@ -350,6 +354,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/auth/BearerAuthProvider.d.ts

@@ -13,7 +13,7 @@ export declare namespace BearerAuthProvider {
     const AUTH_CONFIG_ERROR_MESSAGE: string;
     type Options = AuthOptions;
     type AuthOptions = {
-        [TOKEN_PARAM]: core.Supplier<core.BearerToken>;
+        [TOKEN_PARAM]?: core.Supplier<core.BearerToken> | undefined;
     };
     function createInstance(options: Options): core.AuthProvider;
 }

package/auth/BearerAuthProvider.js

@@ -47,16 +47,19 @@ exports.BearerAuthProvider = void 0;
 const core = __importStar(require("../core"));
 const errors = __importStar(require("../errors/index"));
 const TOKEN_PARAM = "token";
+const ENV_TOKEN = "EXTEND_API_KEY";
 class BearerAuthProvider {
     constructor(options) {
         this.options = options;
     }
     static canCreate(options) {
-        return (options === null || options === void 0 ? void 0 : options[TOKEN_PARAM]) != null;
+        var _a;
+        return (options === null || options === void 0 ? void 0 : options[TOKEN_PARAM]) != null || ((_a = process.env) === null || _a === void 0 ? void 0 : _a[ENV_TOKEN]) != null;
     }
     getAuthRequest() {
         return __awaiter(this, arguments, void 0, function* ({ endpointMetadata, } = {}) {
-            const token = yield core.Supplier.get(this.options[TOKEN_PARAM]);
+            var _a, _b;
+            const token = (_a = (yield core.Supplier.get(this.options[TOKEN_PARAM]))) !== null && _a !== void 0 ? _a : (_b = process.env) === null || _b === void 0 ? void 0 : _b[ENV_TOKEN];
             if (token == null) {
                 throw new errors.ExtendError({
                     message: BearerAuthProvider.AUTH_CONFIG_ERROR_MESSAGE,
@@ -71,7 +74,7 @@ class BearerAuthProvider {
 exports.BearerAuthProvider = BearerAuthProvider;
 (function (BearerAuthProvider) {
     BearerAuthProvider.AUTH_SCHEME = "BearerAuth";
-    BearerAuthProvider.AUTH_CONFIG_ERROR_MESSAGE = `Please provide '${TOKEN_PARAM}' when initializing the client`;
+    BearerAuthProvider.AUTH_CONFIG_ERROR_MESSAGE = `Please provide '${TOKEN_PARAM}' when initializing the client, or set the '${ENV_TOKEN}' environment variable`;
     function createInstance(options) {
         return new BearerAuthProvider(options);
     }

package/package.json

@@ -1,11 +1,12 @@
 {
     "name": "extend-ai",
-    "version": "1.11.0",
+    "version": "1.14.0",
     "private": false,
     "repository": {
         "type": "git",
         "url": "git+https://github.com/extend-hq/extend-typescript-sdk.git"
     },
+    "license": "MIT",
     "main": "./index.js",
     "types": "./index.d.ts",
     "scripts": {