pulse-ts-sdk 1.0.8 → 1.0.10

package/dist/cjs/api/types/FormSharedOptions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Optional knobs accepted by `/form/detect`, `/form/fill`, and `/form/clear` regardless of input mode.
+ */
+export interface FormSharedOptions {
+    /** Restrict the operation to a subset of pages. Accepts comma-separated page numbers and ranges, e.g. `"1-3,5"`. Alias: `pages`. */
+    page_range?: string;
+    /** When `true`, the endpoint returns immediately with `{job_id, status: "pending"}` (HTTP 202) and processes the job in the background. Poll [GET /job/{jobId}](api:GET/job/{jobId}) for the result. Default `false` — return the full result inline. */
+    async?: boolean;
+}

package/dist/cjs/api/types/FormSharedOptions.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/dist/cjs/api/types/GoneErrorBody.d.ts

@@ -0,0 +1,9 @@
+export interface GoneErrorBody {
+    error?: GoneErrorBody.Error_;
+}
+export declare namespace GoneErrorBody {
+    interface Error_ {
+        code?: string;
+        message?: string;
+    }
+}

package/dist/cjs/api/types/GoneErrorBody.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/dist/cjs/api/types/JobStatusResponse.d.ts

@@ -10,7 +10,7 @@ export interface JobStatusResponse {
     created_at: string;
     /** Timestamp of the last status update, if available. */
     updated_at?: string;
-    /** Structured payload that contains output when the job is completed. */
+    /** Structured payload returned when the job completes.  For large extractions (70+ pages) this object contains `is_url: true` and a single-use `url` to download the full result via `GET /large_results/{jobId}`. */
     result?: Record<string, unknown>;
     /** Error message describing why the job failed, if applicable. */
     error?: string;

package/dist/cjs/api/types/PipelineBatchExtractResult.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Result from the batch_extract step in a pipeline.
+ */
+export interface PipelineBatchExtractResult {
+    /** List of extraction IDs for each processed file. */
+    extraction_ids?: string[];
+    /** Number of files processed. */
+    total_files?: number;
+    /** Step execution time in seconds. */
+    latency?: number;
+    /** Accepts any additional properties */
+    [key: string]: any;
+}

package/dist/cjs/api/types/PipelineBatchExtractResult.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/dist/cjs/api/types/PipelineExecuteMultipartInput.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Multipart form-data request body for ad-hoc pipeline execution. Upload file(s) directly and provide step configs as a JSON string.
+ */
+export interface PipelineExecuteMultipartInput {
+    /** Document file to upload. For batch_extract, multiple `file` fields can be provided. */
+    file?: string;
+    /** JSON string containing the step configurations (same structure as `PipelineSteps`). */
+    steps: string;
+    /** Set to `"true"` for async execution. */
+    async?: string;
+    /** Set to `"true"` for zero-retention mode. */
+    auto_delete?: string;
+}

package/dist/cjs/api/types/PipelineExecuteMultipartInput.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/dist/cjs/api/types/PipelineExecuteResponse.d.ts

@@ -0,0 +1,21 @@
+import type * as Pulse from "../index.js";
+/**
+ * Synchronous pipeline execution result. Contains the status, total latency, and results from each step.
+ */
+export interface PipelineExecuteResponse {
+    /** Pipeline execution status. */
+    status: PipelineExecuteResponse.Status;
+    /** Total pipeline execution time in seconds. */
+    total_latency?: number;
+    /** Per-step results. */
+    results: Pulse.PipelineResults;
+    /** Present and true when auto-delete mode was used. Confirms that artifacts have been purged. */
+    auto_delete?: boolean;
+}
+export declare namespace PipelineExecuteResponse {
+    /** Pipeline execution status. */
+    const Status: {
+        readonly Completed: "completed";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/cjs/api/types/PipelineExecuteResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineExecuteResponse = void 0;
+var PipelineExecuteResponse;
+(function (PipelineExecuteResponse) {
+    /** Pipeline execution status. */
+    PipelineExecuteResponse.Status = {
+        Completed: "completed",
+    };
+})(PipelineExecuteResponse || (exports.PipelineExecuteResponse = PipelineExecuteResponse = {}));

package/dist/cjs/api/types/PipelineExtractResult.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Result from the extract step in a pipeline. Inherits all core extraction fields and adds pipeline-specific timing.
+ */
+export interface PipelineExtractResult {
+    /** Primary markdown content extracted from the document. Always present in the new format. */
+    markdown?: string;
+    /** Output from enabled extensions. Each key corresponds to an extension that was enabled in the request under `extensions.*`. Only keys for enabled extensions are present. */
+    extensions?: PipelineExtractResult.Extensions;
+    /** Positional bounding-box data for text, titles, headers, footers, images, and tables. Used by the frontend for annotation overlays. */
+    bounding_boxes?: Record<string, unknown>;
+    /** Persisted extraction ID. Present when storage is enabled (default). Use this ID with `/split` and `/schema` endpoints. */
+    extraction_id?: string;
+    /** URL to view the extraction on the Pulse platform. Present when storage is enabled. */
+    extraction_url?: string;
+    /** Number of pages processed. */
+    page_count?: number;
+    /** Billing tier and usage information. */
+    plan_info?: PipelineExtractResult.PlanInfo;
+    /** Non-fatal warnings generated during extraction. Includes deprecation notices when legacy input parameters are used, as well as processing warnings (e.g. word-level bounding box limitations). */
+    warnings?: string[];
+    /** Number of credits consumed by this request. Only present when the organization has the credit billing system enabled. */
+    credits_used?: number | null;
+    /** Number of pages processed. Convenience alias for `page_count`. */
+    pages?: number;
+    /** Step execution time in seconds. */
+    latency?: number;
+    /** Accepts any additional properties */
+    [key: string]: any;
+}
+export declare namespace PipelineExtractResult {
+    /**
+     * Output from enabled extensions. Each key corresponds to an extension that was enabled in the request under `extensions.*`. Only keys for enabled extensions are present.
+     */
+    interface Extensions {
+        /** Chunk results by strategy. Present when `extensions.chunking` was provided in the request. */
+        chunking?: Extensions.Chunking;
+        /** List of detected footnotes with their in-text references. Present when `extensions.footnoteReferences` was enabled. Each item links a footnote paragraph to the body-text paragraphs that reference it, using bounding-box text IDs. */
+        footnoteReferences?: Extensions.FootnoteReferences.Item[];
+        /** Alternate output formats. Each key corresponds to an enabled alt output. */
+        altOutputs?: Extensions.AltOutputs;
+    }
+    namespace Extensions {
+        /**
+         * Chunk results by strategy. Present when `extensions.chunking` was provided in the request.
+         */
+        interface Chunking {
+            /** Semantically-segmented chunks. */
+            semantic?: string[];
+            /** Chunks split by document headers/headings. */
+            header?: string[];
+            /** One chunk per page. */
+            page?: string[];
+            /** Recursively-split chunks respecting size limits. */
+            recursive?: string[];
+        }
+        type FootnoteReferences = FootnoteReferences.Item[];
+        namespace FootnoteReferences {
+            interface Item {
+                /** The footnote marker symbol (e.g. "*", "†", "1", "#"). */
+                symbol?: string;
+                /** The bounding-box text ID (e.g. "txt-15") of the footnote explanation paragraph. */
+                footnoteTextId?: string;
+                /** Bounding-box text IDs of body-text paragraphs that contain a reference to this footnote marker. */
+                referenceTextIds?: string[];
+            }
+        }
+        /**
+         * Alternate output formats. Each key corresponds to an enabled alt output.
+         */
+        interface AltOutputs {
+            /** Word-level bounding box data. Present when `extensions.altOutputs.wlbb` was enabled and input is a PDF. */
+            wlbb?: AltOutputs.Wlbb;
+            /** HTML representation of the document. Present when `extensions.altOutputs.returnHtml` was enabled. */
+            html?: string;
+            /** XML representation of the document. Present when `extensions.altOutputs.returnXml` was enabled. (WIP) */
+            xml?: string;
+        }
+        namespace AltOutputs {
+            /**
+             * Word-level bounding box data. Present when `extensions.altOutputs.wlbb` was enabled and input is a PDF.
+             */
+            interface Wlbb {
+                /** List of detected words with their positions. */
+                words?: Wlbb.Words.Item[];
+                /** Error message if word-level extraction failed. */
+                error?: string;
+            }
+            namespace Wlbb {
+                type Words = Words.Item[];
+                namespace Words {
+                    interface Item {
+                        /** Unique identifier for the word (e.g. "w-1", "w-2", …). */
+                        id?: string;
+                        /** The recognised word text. */
+                        text?: string;
+                        /** 1-indexed page number in the original document. */
+                        page_number?: number;
+                        /** Flat 4-corner polygon: [x1,y1, x2,y2, x3,y3, x4,y4]. All coordinates normalised to 0–1 range. */
+                        bounding_box?: number[];
+                        /** Recognition confidence score (0–1). */
+                        average_word_confidence?: number;
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Billing tier and usage information.
+     */
+    interface PlanInfo {
+        /** Current plan tier name. */
+        tier?: string;
+        /** Cumulative pages used after this extraction. */
+        pages_used?: number;
+        /** Human-readable plan note. */
+        note?: string;
+    }
+}

package/dist/cjs/api/types/PipelineExtractResult.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/dist/cjs/api/types/PipelineResults.d.ts

@@ -0,0 +1,16 @@
+import type * as Pulse from "../index.js";
+/**
+ * Results from each pipeline step, keyed by step name. Only steps that were executed are present.
+ */
+export interface PipelineResults {
+    /** Extract step result. */
+    extract?: Pulse.PipelineExtractResult;
+    /** Batch extract step result. */
+    batch_extract?: Pulse.PipelineBatchExtractResult;
+    /** Schema step result. */
+    schema?: Pulse.PipelineSchemaResult;
+    /** Split step result. */
+    split?: Pulse.PipelineSplitResult;
+    /** Tables step result. */
+    tables?: Pulse.PipelineTablesResult;
+}

package/dist/cjs/api/types/PipelineResults.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/dist/cjs/api/types/PipelineSchemaResult.d.ts

@@ -0,0 +1,14 @@
+import type * as Pulse from "../index.js";
+/**
+ * Result from the schema step in a pipeline.
+ */
+export interface PipelineSchemaResult {
+    /** Persisted schema version ID. */
+    schema_id?: string;
+    /** Extracted values and citations. */
+    schema_output?: Pulse.StructuredOutputResult;
+    /** Step execution time in seconds. */
+    latency?: number;
+    /** Accepts any additional properties */
+    [key: string]: any;
+}

package/dist/cjs/api/types/PipelineSchemaResult.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/dist/cjs/api/types/PipelineSplitResult.d.ts

@@ -0,0 +1,18 @@
+import type * as Pulse from "../index.js";
+/**
+ * Result from the split step in a pipeline. Inherits all core split fields and adds pipeline-specific timing and input echo.
+ */
+export interface PipelineSplitResult {
+    /** Unique identifier for this split result. Use this ID with the `/schema` endpoint (split mode) to apply schemas to specific page groups. */
+    split_id?: string;
+    /** Page assignments per topic. */
+    split_output?: Pulse.SplitOutput;
+    /** Number of credits consumed by this request. Only present when the organization has the credit billing system enabled. */
+    credits_used?: number | null;
+    /** Echo of the topic definitions used. */
+    split_input?: Pulse.TopicDefinition[];
+    /** Step execution time in seconds. */
+    latency?: number;
+    /** Accepts any additional properties */
+    [key: string]: any;
+}

package/dist/cjs/api/types/PipelineSplitResult.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/dist/cjs/api/types/PipelineStepBatchExtractConfig.d.ts

@@ -0,0 +1,147 @@
+import type * as Pulse from "../index.js";
+/**
+ * Configuration for the batch_extract step. Same extract options as `POST /extract` (applied to every file) plus file inputs and a `workers` field for parallelism. Provide files via `file_urls` (URL list) or `files` (base64 inline uploads).
+ */
+export interface PipelineStepBatchExtractConfig {
+    /** Extraction model to use. When set to `pulse-ultra-2`, routes the request through Pulse Ultra 2 (self-hosted VPC model) instead of the default cloud-based service. If omitted or set to `default`, the default model is used. */
+    model?: PipelineStepBatchExtractConfig.Model;
+    /** Page range filter supporting segments such as `1-2` or mixed ranges like `1-2,5`. */
+    pages?: string;
+    /** Settings that control how figures in the document are processed. These affect the markdown output directly (e.g. figure descriptions, chart-to-table conversion, image embedding) and do not produce additional output fields in the response. */
+    figureProcessing?: PipelineStepBatchExtractConfig.FigureProcessing;
+    /** Settings that enable additional processing passes or alternate output formats. Each enabled extension produces a corresponding output field under `response.extensions.*`. */
+    extensions?: PipelineStepBatchExtractConfig.Extensions;
+    /** Settings for Excel/spreadsheet extraction. Controls handling of hidden rows, columns, and sheets. Only applies to `.xlsx` and `.xls` files. Accepts both camelCase and snake_case field names. */
+    spreadsheet?: PipelineStepBatchExtractConfig.Spreadsheet;
+    /** Options for persisting extraction artifacts. When enabled (default), artifacts are saved to storage and a database record is created. */
+    storage?: PipelineStepBatchExtractConfig.Storage;
+    /** If true, returns immediately with a job_id for polling via GET /job/{jobId}. Otherwise processes synchronously. */
+    async?: boolean;
+    /** **⚠️ DEPRECATED** — Use the `/schema` endpoint after extraction instead. Pass the `extraction_id` from the extract response to `/schema` with your `schema_config`. This parameter still works for backward compatibility but will be removed in a future version. */
+    structuredOutput?: PipelineStepBatchExtractConfig.StructuredOutput;
+    /** (Deprecated) JSON schema describing structured data to extract. Use structuredOutput instead. Accepts either a JSON object or a stringified JSON representation. */
+    schema?: PipelineStepBatchExtractConfig.Schema;
+    /** (Deprecated) Natural language prompt for schema-guided extraction. Use structuredOutput.schemaPrompt instead. */
+    schemaPrompt?: string;
+    /** (Deprecated) Custom instructions that augment the default extraction behaviour. Use `figureProcessing` or `extensions` instead. */
+    customPrompt?: string;
+    /** **⚠️ DEPRECATED** — Use `extensions.chunking.chunkTypes` instead. Comma-separated list of chunking strategies to apply (for example `semantic,header,page,recursive`). Still accepted for backward compatibility. */
+    chunking?: string;
+    /** **⚠️ DEPRECATED** — Use `extensions.chunking.chunkSize` instead. Override for maximum characters per chunk when chunking is enabled. */
+    chunkSize?: number;
+    /** **⚠️ DEPRECATED** — Toggle to enable figure extraction in results. */
+    extractFigure?: boolean;
+    /** **⚠️ DEPRECATED** — Use `figureProcessing.description` instead. Toggle to generate descriptive captions for extracted figures. */
+    figureDescription?: boolean;
+    /** **⚠️ DEPRECATED** — Use `figureProcessing.showImages` instead. Embed base64-encoded images inline in figure tags in the output. Increases response size. */
+    showImages?: boolean;
+    /** **⚠️ DEPRECATED** — Use `extensions.altOutputs.returnHtml` instead. Whether to include HTML representation alongside markdown in the response. */
+    returnHtml?: boolean;
+    /** (Deprecated) Enables expanded rationale output for debugging. */
+    thinking?: boolean;
+    /** List of document URLs to process in parallel. */
+    file_urls?: string[];
+    /** Inline file uploads. Each entry contains a filename and base64-encoded file content. Use instead of `file_urls` when you have local files. */
+    files?: Pulse.BatchFileUpload[];
+    /** Number of parallel workers. */
+    workers?: number;
+}
+export declare namespace PipelineStepBatchExtractConfig {
+    /** Extraction model to use. When set to `pulse-ultra-2`, routes the request through Pulse Ultra 2 (self-hosted VPC model) instead of the default cloud-based service. If omitted or set to `default`, the default model is used. */
+    const Model: {
+        readonly Default: "default";
+        readonly PulseUltra2: "pulse-ultra-2";
+    };
+    type Model = (typeof Model)[keyof typeof Model];
+    /**
+     * Settings that control how figures in the document are processed. These affect the markdown output directly (e.g. figure descriptions, chart-to-table conversion, image embedding) and do not produce additional output fields in the response.
+     */
+    interface FigureProcessing {
+        /** Generate descriptive captions for extracted figures. */
+        description?: boolean;
+        /** Embed base64-encoded images inline in figure tags in the output. Increases response size. */
+        showImages?: boolean;
+    }
+    /**
+     * Settings that enable additional processing passes or alternate output formats. Each enabled extension produces a corresponding output field under `response.extensions.*`.
+     */
+    interface Extensions {
+        /** Link footnote markers to their corresponding footnote text. */
+        footnoteReferences?: boolean;
+        /** Chunking configuration. When provided, the document is split into chunks using the specified strategies. Results appear in `response.extensions.chunking`. */
+        chunking?: Extensions.Chunking;
+        /** Alternate output format options. Each enabled format produces a corresponding field under `response.extensions.altOutputs`. */
+        altOutputs?: Extensions.AltOutputs;
+    }
+    namespace Extensions {
+        /**
+         * Chunking configuration. When provided, the document is split into chunks using the specified strategies. Results appear in `response.extensions.chunking`.
+         */
+        interface Chunking {
+            /** List of chunking strategies to apply (e.g. `["semantic", "header", "page", "recursive"]`). */
+            chunkTypes?: Chunking.ChunkTypes.Item[];
+            /** Maximum characters per chunk. */
+            chunkSize?: number;
+        }
+        namespace Chunking {
+            type ChunkTypes = ChunkTypes.Item[];
+            namespace ChunkTypes {
+                const Item: {
+                    readonly Semantic: "semantic";
+                    readonly Header: "header";
+                    readonly Page: "page";
+                    readonly Recursive: "recursive";
+                };
+                type Item = (typeof Item)[keyof typeof Item];
+            }
+        }
+        /**
+         * Alternate output format options. Each enabled format produces a corresponding field under `response.extensions.altOutputs`.
+         */
+        interface AltOutputs {
+            /** Enable word-level bounding boxes. Runs an additional OCR model to derive bounding boxes for each word. Only applies to PDFs. Results in `response.extensions.altOutputs.wlbb`. */
+            wlbb?: boolean;
+            /** Include an HTML representation of the document. When enabled, `response.markdown` is still present and the HTML is available at `response.extensions.altOutputs.html`. */
+            returnHtml?: boolean;
+            /** Include an XML representation of the document. Results in `response.extensions.altOutputs.xml`. (Work in progress.) */
+            returnXml?: boolean;
+        }
+    }
+    /**
+     * Settings for Excel/spreadsheet extraction. Controls handling of hidden rows, columns, and sheets. Only applies to `.xlsx` and `.xls` files. Accepts both camelCase and snake_case field names.
+     */
+    interface Spreadsheet {
+        /** Include rows that are hidden in the Excel workbook. */
+        includeHiddenRows?: boolean;
+        /** Include columns that are hidden in the Excel workbook. */
+        includeHiddenCols?: boolean;
+        /** Include sheets that are hidden in the Excel workbook. */
+        includeHiddenSheets?: boolean;
+    }
+    /**
+     * Options for persisting extraction artifacts. When enabled (default), artifacts are saved to storage and a database record is created.
+     */
+    interface Storage {
+        /** Whether to persist extraction artifacts. Set to false for temporary extractions with no storage or database record. */
+        enabled?: boolean;
+        /** Target folder name to save the extraction to. Creates the folder if it doesn't exist. */
+        folderName?: string;
+        /** Target folder ID to save the extraction to. Takes precedence over folderName if both are provided. */
+        folderId?: string;
+    }
+    /**
+     * **⚠️ DEPRECATED** — Use the `/schema` endpoint after extraction instead. Pass the `extraction_id` from the extract response to `/schema` with your `schema_config`. This parameter still works for backward compatibility but will be removed in a future version.
+     */
+    interface StructuredOutput {
+        /** JSON schema describing the structured data to extract. */
+        schema?: Record<string, unknown>;
+        /** Natural language prompt with additional extraction instructions. */
+        schemaPrompt?: string;
+        /** Use higher quality model for better results. When true, uses a more capable model at the cost of higher latency. */
+        effort?: boolean;
+    }
+    /**
+     * (Deprecated) JSON schema describing structured data to extract. Use structuredOutput instead. Accepts either a JSON object or a stringified JSON representation.
+     */
+    type Schema = Record<string, unknown> | string;
+}

package/dist/cjs/api/types/PipelineStepBatchExtractConfig.js

@@ -0,0 +1,27 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineStepBatchExtractConfig = void 0;
+var PipelineStepBatchExtractConfig;
+(function (PipelineStepBatchExtractConfig) {
+    /** Extraction model to use. When set to `pulse-ultra-2`, routes the request through Pulse Ultra 2 (self-hosted VPC model) instead of the default cloud-based service. If omitted or set to `default`, the default model is used. */
+    PipelineStepBatchExtractConfig.Model = {
+        Default: "default",
+        PulseUltra2: "pulse-ultra-2",
+    };
+    let Extensions;
+    (function (Extensions) {
+        let Chunking;
+        (function (Chunking) {
+            let ChunkTypes;
+            (function (ChunkTypes) {
+                ChunkTypes.Item = {
+                    Semantic: "semantic",
+                    Header: "header",
+                    Page: "page",
+                    Recursive: "recursive",
+                };
+            })(ChunkTypes = Chunking.ChunkTypes || (Chunking.ChunkTypes = {}));
+        })(Chunking = Extensions.Chunking || (Extensions.Chunking = {}));
+    })(Extensions = PipelineStepBatchExtractConfig.Extensions || (PipelineStepBatchExtractConfig.Extensions = {}));
+})(PipelineStepBatchExtractConfig || (exports.PipelineStepBatchExtractConfig = PipelineStepBatchExtractConfig = {}));

package/dist/cjs/api/types/PipelineSteps.d.ts

@@ -0,0 +1,16 @@
+import type * as Pulse from "../index.js";
+/**
+ * Ordered step definitions. Key order determines execution order. Use `extract` for single-file or `batch_extract` for multi-file pipelines — they are mutually exclusive. Each step accepts the same configuration as its standalone endpoint.
+ */
+export interface PipelineSteps {
+    /** Single-document extraction step. Same options as `POST /extract`. */
+    extract?: Pulse.ExtractOptions;
+    /** Multi-document parallel extraction step. Provide `file_urls` at the top level and optional `workers` here. */
+    batch_extract?: Pulse.PipelineStepBatchExtractConfig;
+    /** Structured data extraction step. Same config as `schema_config` in `POST /schema`. Requires `extract` or `batch_extract` before it. */
+    schema?: Pulse.SchemaConfig;
+    /** Topic splitting step. Same config as `split_config` in `POST /split`. Requires `extract` or `batch_extract` before it. */
+    split?: Pulse.SplitConfig;
+    /** Table extraction step. Same config as `tables_config` in `POST /tables`. Requires `extract` before it. This is a terminal step — no further steps can follow. */
+    tables?: Pulse.TablesConfig;
+}

package/dist/cjs/api/types/PipelineSteps.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/dist/cjs/api/types/PipelineTablesResult.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Result from the tables step in a pipeline.
+ */
+export interface PipelineTablesResult {
+    /** Persisted tables version ID. */
+    tables_id?: string;
+    /** The extracted tables data. */
+    tables_output?: PipelineTablesResult.TablesOutput;
+    /** Step execution time in seconds. */
+    latency?: number;
+    /** Accepts any additional properties */
+    [key: string]: any;
+}
+export declare namespace PipelineTablesResult {
+    /**
+     * The extracted tables data.
+     */
+    interface TablesOutput {
+        /** Array of extracted table objects. Each table includes its content, citations, and whether it was derived from a chart. */
+        tables?: TablesOutput.Tables.Item[];
+    }
+    namespace TablesOutput {
+        type Tables = Tables.Item[];
+        namespace Tables {
+            interface Item {
+                /** The table content. When `table_format` is `html` (default), this is an HTML string. When `json`, this is an object with `headers` and `rows`. */
+                table_content?: unknown;
+                citations?: string[];
+                from_chart?: boolean;
+            }
+        }
+    }
+}

package/dist/cjs/api/types/PipelineTablesResult.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/dist/cjs/api/types/SingleSchemaResponse.d.ts

@@ -13,4 +13,6 @@ export interface SingleSchemaResponse {
     extraction_ids?: string[];
     /** API path to download the filled Excel template (e.g. `/schema/{schema_id}/excel`). Requires the same API key authentication. Only present when `excel_template` was provided in the request. */
     excel_output_url?: string;
+    /** Number of credits consumed by this request. Only present when the organization has the credit billing system enabled. */
+    credits_used?: number | null;
 }

package/dist/cjs/api/types/SplitResponse.d.ts

@@ -2,9 +2,4 @@ import type * as Pulse from "../index.js";
 /**
  * Result of document splitting with page assignments.
  */
-export interface SplitResponse {
-    /** Unique identifier for this split result. Use this ID with the `/schema` endpoint (split mode) to apply schemas to specific page groups. */
-    split_id: string;
-    /** Page assignments per topic. */
-    split_output: Pulse.SplitOutput;
-}
+export type SplitResponse = Pulse.SplitResultCore;

package/dist/cjs/api/types/SplitResultCore.d.ts

@@ -0,0 +1,12 @@
+import type * as Pulse from "../index.js";
+/**
+ * Core split result fields shared by the synchronous `/split` endpoint and the pipeline split step.
+ */
+export interface SplitResultCore {
+    /** Unique identifier for this split result. Use this ID with the `/schema` endpoint (split mode) to apply schemas to specific page groups. */
+    split_id?: string;
+    /** Page assignments per topic. */
+    split_output?: Pulse.SplitOutput;
+    /** Number of credits consumed by this request. Only present when the organization has the credit billing system enabled. */
+    credits_used?: number | null;
+}

package/dist/cjs/api/types/SplitResultCore.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/dist/cjs/api/types/SplitSchemaResponse.d.ts

@@ -13,4 +13,6 @@ export interface SplitSchemaResponse {
     input_schemas?: Record<string, Record<string, unknown>>;
     /** Per-topic errors if any topics failed to process. Keys are topic names, values are error messages. */
     errors?: Record<string, string>;
+    /** Number of credits consumed by this request. Only present when the organization has the credit billing system enabled. */
+    credits_used?: number | null;
 }

package/dist/cjs/api/types/TablesConfig.d.ts

@@ -4,13 +4,16 @@
 export interface TablesConfig {
     /** When true, adjacent tables that appear to be continuations of each other are merged into a single table. */
     merge?: boolean;
-    /** Output format for table content. Currently only `html` is supported. */
+    /** Output format for table content. `html` returns an HTML `<table>` string. `json` returns a structured object with `headers` (array of column names) and `rows` (array of objects keyed by header name). */
     table_format?: TablesConfig.TableFormat;
+    /** Convert figures and charts into tables using LLM processing. Resulting tables have `from_chart: true` in the response. */
+    charts_to_tables?: boolean;
 }
 export declare namespace TablesConfig {
-    /** Output format for table content. Currently only `html` is supported. */
+    /** Output format for table content. `html` returns an HTML `<table>` string. `json` returns a structured object with `headers` (array of column names) and `rows` (array of objects keyed by header name). */
     const TableFormat: {
         readonly Html: "html";
+        readonly Json: "json";
     };
     type TableFormat = (typeof TableFormat)[keyof typeof TableFormat];
 }

package/dist/cjs/api/types/TablesConfig.js

@@ -4,8 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TablesConfig = void 0;
 var TablesConfig;
 (function (TablesConfig) {
-    /** Output format for table content. Currently only `html` is supported. */
+    /** Output format for table content. `html` returns an HTML `<table>` string. `json` returns a structured object with `headers` (array of column names) and `rows` (array of objects keyed by header name). */
     TablesConfig.TableFormat = {
         Html: "html",
+        Json: "json",
     };
 })(TablesConfig || (exports.TablesConfig = TablesConfig = {}));