@retab/node 1.0.96 → 1.0.99

package/dist/api/workflows/runs/client.js

@@ -1,7 +1,23 @@
+import * as z from "zod";
 import { CompositionClient } from "../../../client.js";
-import { ZMIMEData, ZWorkflowRun, ZPaginatedList, ZCancelWorkflowResponse, ZResumeWorkflowResponse, } from "../../../types.js";
+import { ZMIMEData, ZWorkflowRun, ZPaginatedList, ZCancelWorkflowResponse, ZResumeWorkflowResponse, ZWorkflowRunExportResponse, } from "../../../types.js";
 import APIWorkflowRunSteps from "./steps/client.js";
 const TERMINAL_STATUSES = new Set(["completed", "error", "cancelled"]);
+function normalizeCsvParam(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return Array.isArray(value) ? value.join(",") : value;
+}
+function normalizeDateParam(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value instanceof Date) {
+        return value.toISOString().slice(0, 10);
+    }
+    return value;
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -9,7 +25,7 @@ function sleep(ms) {
  * Workflow Runs API client for managing workflow executions.
  *
  * Sub-clients:
- * - steps: Step output operations (get, list)
+ * - steps: Step output operations (get, list, getMany, getAll)
  */
 export default class APIWorkflowRuns extends CompositionClient {
     constructor(client) {
@@ -23,24 +39,12 @@ export default class APIWorkflowRuns extends CompositionClient {
      * The returned WorkflowRun will have status "running" - use get()
      * to check for updates on the run status.
      *
-     * @param workflowId - The ID of the workflow to run
-     * @param documents - Mapping of start node IDs to their input documents
-     * @param jsonInputs - Mapping of start_json node IDs to their input JSON data
-     * @param options - Optional request options
-     * @returns The created workflow run with status "running"
-     *
      * @example
      * ```typescript
      * const run = await client.workflows.runs.create({
      *     workflowId: "wf_abc123",
-     *     documents: {
-     *         "start-node-1": "./invoice.pdf",
-     *     },
-     *     jsonInputs: {
-     *         "json-node-1": { key: "value" },
-     *     },
+     *     documents: { "start-node-1": "./invoice.pdf" },
      * });
-     * console.log(`Run started: ${run.id}, status: ${run.status}`);
      * ```
      */
     async create({ workflowId, documents, jsonInputs, }, options) {
@@ -64,7 +68,7 @@ export default class APIWorkflowRuns extends CompositionClient {
             body.json_inputs = jsonInputs;
         }
         return this._fetchJson(ZWorkflowRun, {
-            url: `/v1/workflows/${workflowId}/run`,
+            url: `/workflows/${workflowId}/run`,
             method: "POST",
             body: { ...body, ...(options?.body || {}) },
             params: options?.params,
@@ -73,20 +77,10 @@ export default class APIWorkflowRuns extends CompositionClient {
     }
     /**
      * Get a workflow run by ID.
-     *
-     * @param runId - The ID of the workflow run to retrieve
-     * @param options - Optional request options
-     * @returns The workflow run
-     *
-     * @example
-     * ```typescript
-     * const run = await client.workflows.runs.get("run_abc123");
-     * console.log(`Run status: ${run.status}`);
-     * ```
      */
     async get(runId, options) {
         return this._fetchJson(ZWorkflowRun, {
-            url: `/v1/workflows/runs/${runId}`,
+            url: `/workflows/runs/${runId}`,
             method: "GET",
             params: options?.params,
             headers: options?.headers,
@@ -94,35 +88,25 @@ export default class APIWorkflowRuns extends CompositionClient {
     }
     /**
      * List workflow runs with filtering and pagination.
-     *
-     * @example
-     * ```typescript
-     * const runs = await client.workflows.runs.list({
-     *     workflowId: "wf_abc123",
-     *     status: "completed",
-     *     limit: 10,
-     * });
-     * console.log(`Found ${runs.data.length} runs`);
-     * ```
      */
     async list({ workflowId, status, statuses, excludeStatus, triggerType, triggerTypes, fromDate, toDate, minCost, maxCost, minDuration, maxDuration, search, sortBy, fields, before, after, limit = 20, order = "desc", } = {}, options) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const params = {
             workflow_id: workflowId,
             status,
-            statuses,
+            statuses: normalizeCsvParam(statuses),
             exclude_status: excludeStatus,
             trigger_type: triggerType,
-            trigger_types: triggerTypes,
-            from_date: fromDate,
-            to_date: toDate,
+            trigger_types: normalizeCsvParam(triggerTypes),
+            from_date: normalizeDateParam(fromDate),
+            to_date: normalizeDateParam(toDate),
             min_cost: minCost,
             max_cost: maxCost,
             min_duration: minDuration,
             max_duration: maxDuration,
             search,
             sort_by: sortBy,
-            fields,
+            fields: normalizeCsvParam(fields),
             before,
             after,
             limit,
@@ -130,7 +114,7 @@ export default class APIWorkflowRuns extends CompositionClient {
         };
         const cleanParams = Object.fromEntries(Object.entries(params).filter(([_, v]) => v !== undefined));
         return this._fetchJson(ZPaginatedList, {
-            url: "/v1/workflows/runs",
+            url: "/workflows/runs",
             method: "GET",
             params: { ...cleanParams, ...(options?.params || {}) },
             headers: options?.headers,
@@ -138,18 +122,10 @@ export default class APIWorkflowRuns extends CompositionClient {
     }
     /**
      * Delete a workflow run and its associated step data.
-     *
-     * @param runId - The ID of the workflow run to delete
-     * @param options - Optional request options
-     *
-     * @example
-     * ```typescript
-     * await client.workflows.runs.delete("run_abc123");
-     * ```
      */
     async delete(runId, options) {
         return this._fetchJson({
-            url: `/v1/workflows/runs/${runId}`,
+            url: `/workflows/runs/${runId}`,
             method: "DELETE",
             params: options?.params,
             headers: options?.headers,
@@ -157,17 +133,6 @@ export default class APIWorkflowRuns extends CompositionClient {
     }
     /**
      * Cancel a running or pending workflow run.
-     *
-     * @param runId - The ID of the workflow run to cancel
-     * @param commandId - Optional idempotency key for deduplicating cancel commands
-     * @param options - Optional request options
-     * @returns The updated run with cancellation status
-     *
-     * @example
-     * ```typescript
-     * const result = await client.workflows.runs.cancel("run_abc123");
-     * console.log(`Cancellation: ${result.cancellation_status}`);
-     * ```
      */
     async cancel(runId, { commandId } = {}, options) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -175,7 +140,7 @@ export default class APIWorkflowRuns extends CompositionClient {
         if (commandId !== undefined)
             body.command_id = commandId;
         return this._fetchJson(ZCancelWorkflowResponse, {
-            url: `/v1/workflows/runs/${runId}/cancel`,
+            url: `/workflows/runs/${runId}/cancel`,
             method: "POST",
             body: { ...body, ...(options?.body || {}) },
             params: options?.params,
@@ -184,17 +149,6 @@ export default class APIWorkflowRuns extends CompositionClient {
     }
     /**
      * Restart a completed or failed workflow run with the same inputs.
-     *
-     * @param runId - The ID of the workflow run to restart
-     * @param commandId - Optional idempotency key for deduplicating restart commands
-     * @param options - Optional request options
-     * @returns The new workflow run
-     *
-     * @example
-     * ```typescript
-     * const newRun = await client.workflows.runs.restart("run_abc123");
-     * console.log(`New run: ${newRun.id}`);
-     * ```
      */
     async restart(runId, { commandId } = {}, options) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -202,7 +156,7 @@ export default class APIWorkflowRuns extends CompositionClient {
         if (commandId !== undefined)
             body.command_id = commandId;
         return this._fetchJson(ZWorkflowRun, {
-            url: `/v1/workflows/runs/${runId}/restart`,
+            url: `/workflows/runs/${runId}/restart`,
             method: "POST",
             body: { ...body, ...(options?.body || {}) },
             params: options?.params,
@@ -211,24 +165,6 @@ export default class APIWorkflowRuns extends CompositionClient {
     }
     /**
      * Resume a workflow run after human-in-the-loop (HIL) review.
-     *
-     * @param runId - The ID of the workflow run to resume
-     * @param nodeId - The ID of the HIL node being approved/rejected
-     * @param approved - Whether the human approved the data
-     * @param modifiedData - Optional modified data if the human made changes
-     * @param commandId - Optional idempotency key for deduplicating resume commands
-     * @param options - Optional request options
-     * @returns The resume response with status and queue information
-     *
-     * @example
-     * ```typescript
-     * const result = await client.workflows.runs.resume("run_abc123", {
-     *     nodeId: "hil-node-1",
-     *     approved: true,
-     *     modifiedData: { field: "corrected value" },
-     * });
-     * console.log(`Resume status: ${result.resume_status}`);
-     * ```
      */
     async resume(runId, { nodeId, approved, modifiedData, commandId, }, options) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -241,7 +177,7 @@ export default class APIWorkflowRuns extends CompositionClient {
         if (commandId !== undefined)
             body.command_id = commandId;
         return this._fetchJson(ZResumeWorkflowResponse, {
-            url: `/v1/workflows/runs/${runId}/resume`,
+            url: `/workflows/runs/${runId}/resume`,
             method: "POST",
             body: { ...body, ...(options?.body || {}) },
             params: options?.params,
@@ -251,24 +187,21 @@ export default class APIWorkflowRuns extends CompositionClient {
     /**
      * Poll a workflow run until it reaches a terminal state.
      *
-     * Terminal states: "completed", "error", "cancelled".
+     * Terminal states: "completed", "error", "cancelled", "waiting_for_human".
      *
      * @param runId - The ID of the workflow run to wait for
      * @param pollIntervalMs - Milliseconds between polls (default: 2000)
      * @param timeoutMs - Maximum time to wait in milliseconds (default: 600000 = 10 minutes)
-     * @returns The workflow run in a terminal state
-     * @throws Error if the run doesn't complete within the timeout
+     * @param onStatus - Optional callback invoked with the WorkflowRun on each poll
      *
      * @example
      * ```typescript
      * const run = await client.workflows.runs.waitForCompletion("run_abc123", {
-     *     pollIntervalMs: 1000,
-     *     timeoutMs: 300000,
+     *     onStatus: (r) => console.log(`${r.status}...`),
      * });
-     * console.log(`Final status: ${run.status}`);
      * ```
      */
-    async waitForCompletion(runId, { pollIntervalMs = 2000, timeoutMs = 600000, } = {}) {
+    async waitForCompletion(runId, { pollIntervalMs = 2000, timeoutMs = 600000, onStatus, } = {}) {
         if (pollIntervalMs <= 0)
             throw new Error("pollIntervalMs must be positive");
         if (timeoutMs <= 0)
@@ -276,7 +209,9 @@ export default class APIWorkflowRuns extends CompositionClient {
         const deadline = Date.now() + timeoutMs;
         while (true) {
             const run = await this.get(runId);
-            if (TERMINAL_STATUSES.has(run.status)) {
+            if (onStatus)
+                await onStatus(run);
+            if (TERMINAL_STATUSES.has(run.status) || run.status === "waiting_for_human") {
                 return run;
             }
             if (Date.now() >= deadline) {
@@ -285,33 +220,97 @@ export default class APIWorkflowRuns extends CompositionClient {
             await sleep(pollIntervalMs);
         }
     }
+    async wait_for_completion(runId, { poll_interval_ms = 2000, timeout_ms = 600000, on_status, } = {}) {
+        return this.waitForCompletion(runId, {
+            pollIntervalMs: poll_interval_ms,
+            timeoutMs: timeout_ms,
+            onStatus: on_status,
+        });
+    }
     /**
      * Create a workflow run and wait for it to complete.
      *
-     * Convenience method that combines create() and waitForCompletion().
-     *
-     * @param workflowId - The ID of the workflow to run
-     * @param documents - Mapping of start node IDs to their input documents
-     * @param jsonInputs - Mapping of start_json node IDs to their input JSON data
-     * @param pollIntervalMs - Milliseconds between polls (default: 2000)
-     * @param timeoutMs - Maximum time to wait in milliseconds (default: 600000)
-     * @param options - Optional request options
-     * @returns The workflow run in a terminal state
-     *
      * @example
      * ```typescript
+     * import { raiseForStatus } from "retab";
+     *
      * const run = await client.workflows.runs.createAndWait({
      *     workflowId: "wf_abc123",
      *     documents: { "start-node-1": "./invoice.pdf" },
-     *     timeoutMs: 120000,
+     *     onStatus: (r) => console.log(`${r.status}...`),
      * });
-     * if (run.status === "completed") {
-     *     console.log("Outputs:", run.final_outputs);
-     * }
+     * raiseForStatus(run);
+     * console.log(run.final_outputs);
      * ```
      */
-    async createAndWait({ workflowId, documents, jsonInputs, pollIntervalMs = 2000, timeoutMs = 600000, }, options) {
+    async createAndWait({ workflowId, documents, jsonInputs, pollIntervalMs = 2000, timeoutMs = 600000, onStatus, }, options) {
         const run = await this.create({ workflowId, documents, jsonInputs }, options);
-        return this.waitForCompletion(run.id, { pollIntervalMs, timeoutMs });
+        return this.waitForCompletion(run.id, { pollIntervalMs, timeoutMs, onStatus });
+    }
+    /**
+     * Get the configuration snapshot used for a run.
+     */
+    async getConfig(runId, options) {
+        return this._fetchJson(z.record(z.any()), {
+            url: `/workflows/runs/${runId}/config`,
+            method: "GET",
+            params: options?.params,
+            headers: options?.headers,
+        });
+    }
+    /**
+     * Get the DAG-ordered execution order for a run.
+     */
+    async executionOrder(runId, options) {
+        return this._fetchJson(z.record(z.any()), {
+            url: `/workflows/runs/${runId}/execution-order`,
+            method: "GET",
+            params: options?.params,
+            headers: options?.headers,
+        });
+    }
+    /**
+     * Get a signed URL for downloading a document from a run step.
+     */
+    async getDocumentUrl(runId, nodeId, options) {
+        return this._fetchJson(z.record(z.any()), {
+            url: `/workflows/runs/${runId}/documents/${nodeId}`,
+            method: "GET",
+            params: options?.params,
+            headers: options?.headers,
+        });
+    }
+    /**
+     * Export run results as structured CSV data.
+     *
+     * @returns Object with `csv_data` (string), `rows` (number), `columns` (number)
+     */
+    async export({ workflowId, nodeId, exportSource = "outputs", selectedRunIds, status, excludeStatus, fromDate, toDate, triggerTypes, preferredColumns, }, options) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const body = {
+            workflow_id: workflowId,
+            node_id: nodeId,
+            export_source: exportSource,
+            preferred_columns: preferredColumns || [],
+        };
+        if (selectedRunIds !== undefined)
+            body.selected_run_ids = selectedRunIds;
+        if (status !== undefined)
+            body.status = status;
+        if (excludeStatus !== undefined)
+            body.exclude_status = excludeStatus;
+        if (fromDate !== undefined)
+            body.from_date = normalizeDateParam(fromDate);
+        if (toDate !== undefined)
+            body.to_date = normalizeDateParam(toDate);
+        if (triggerTypes !== undefined)
+            body.trigger_types = triggerTypes;
+        return this._fetchJson(ZWorkflowRunExportResponse, {
+            url: "/workflows/runs/export_payload",
+            method: "POST",
+            body: { ...body, ...(options?.body || {}) },
+            params: options?.params,
+            headers: options?.headers,
+        });
     }
 }

package/dist/api/workflows/runs/steps/client.d.ts

@@ -1,34 +1,25 @@
 import { CompositionClient, RequestOptions } from "../../../../client.js";
-import { StepOutputResponse, WorkflowRunStep } from "../../../../types.js";
+import { StepOutputResponse, StepOutputsBatchResponse, WorkflowRunStep, WorkflowRun } from "../../../../types.js";
 /**
  * Workflow Run Steps API client for accessing step-level outputs.
  *
- * Usage: `client.workflows.runs.steps.get(runId, nodeId)` or `client.workflows.runs.steps.list(runId)`
+ * Usage: `client.workflows.runs.steps.get(runId, nodeId)` or `client.workflows.runs.steps.getMany(runId, nodeIds)`
  */
 export default class APIWorkflowRunSteps extends CompositionClient {
     constructor(client: CompositionClient);
     /**
-     * Get the full output data for a specific step in a workflow run.
-     *
-     * @param runId - The ID of the workflow run
-     * @param nodeId - The ID of the node/step to get output for
-     * @param options - Optional request options
-     * @returns The step output with handle outputs and inputs
+     * Get step status and handle data for a specific step in a workflow run.
      *
      * @example
      * ```typescript
      * const step = await client.workflows.runs.steps.get("run_abc123", "extract-node-1");
-     * console.log(`Step status: ${step.status}, output:`, step.output);
+     * const data = step.handle_outputs?.["output-json-0"]?.data;
      * ```
      */
     get(runId: string, nodeId: string, options?: RequestOptions): Promise<StepOutputResponse>;
     /**
      * List all persisted step documents for a workflow run.
      *
-     * @param runId - The ID of the workflow run
-     * @param options - Optional request options
-     * @returns All step documents for the run
-     *
      * @example
      * ```typescript
      * const steps = await client.workflows.runs.steps.list("run_abc123");
@@ -38,5 +29,36 @@ export default class APIWorkflowRunSteps extends CompositionClient {
      * ```
      */
     list(runId: string, options?: RequestOptions): Promise<WorkflowRunStep[]>;
+    /**
+     * Batch-get step outputs for multiple nodes in a single request.
+     *
+     * @param runId - The workflow run ID
+     * @param nodeIds - List of node IDs to fetch outputs for
+     * @returns Step outputs keyed by node ID
+     *
+     * @example
+     * ```typescript
+     * const batch = await client.workflows.runs.steps.getMany("run_abc123", ["extract-1", "classifier-1"]);
+     * console.log(batch.outputs["extract-1"]?.handle_outputs);
+     * ```
+     */
+    getMany(runId: string, nodeIds: string[], options?: RequestOptions): Promise<StepOutputsBatchResponse>;
+    get_many(runId: string, nodeIds: string[], options?: RequestOptions): Promise<StepOutputsBatchResponse>;
+    /**
+     * Fetch outputs for all steps in a workflow run in one call.
+     *
+     * Internally fetches the run to discover step node IDs, then batch-fetches all outputs.
+     *
+     * @param runId - The workflow run ID
+     * @returns Step outputs keyed by node ID
+     *
+     * @example
+     * ```typescript
+     * const allOutputs = await client.workflows.runs.steps.getAll("run_abc123");
+     * console.log(allOutputs.outputs["extract-1"]?.handle_outputs);
+     * ```
+     */
+    getAll(run: WorkflowRun | string, options?: RequestOptions): Promise<StepOutputsBatchResponse>;
+    get_all(run: WorkflowRun | string, options?: RequestOptions): Promise<StepOutputsBatchResponse>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/api/workflows/runs/steps/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../src/api/workflows/runs/steps/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EACH,kBAAkB,EAElB,eAAe,EAElB,MAAM,sBAAsB,CAAC;AAG9B;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,iBAAiB;gBAClD,MAAM,EAAE,iBAAiB;IAIrC;;;;;;;;;;;;;OAaG;IACG,GAAG,CACL,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,kBAAkB,CAAC;IAS9B;;;;;;;;;;;;;;OAcG;IACG,IAAI,CACN,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,eAAe,EAAE,CAAC;CAQhC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../src/api/workflows/runs/steps/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EACH,kBAAkB,EAElB,wBAAwB,EAExB,eAAe,EAEf,WAAW,EAEd,MAAM,sBAAsB,CAAC;AAG9B;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,iBAAiB;gBAClD,MAAM,EAAE,iBAAiB;IAIrC;;;;;;;;OAQG;IACG,GAAG,CACL,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,kBAAkB,CAAC;IAS9B;;;;;;;;;;OAUG;IACG,IAAI,CACN,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,eAAe,EAAE,CAAC;IAS7B;;;;;;;;;;;;OAYG;IACG,OAAO,CACT,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,wBAAwB,CAAC;IAU9B,QAAQ,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,wBAAwB,CAAC;IAIpC;;;;;;;;;;;;;OAaG;IACG,MAAM,CACR,GAAG,EAAE,WAAW,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,wBAAwB,CAAC;IAkB9B,OAAO,CACT,GAAG,EAAE,WAAW,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,wBAAwB,CAAC;CAGvC"}

package/dist/api/workflows/runs/steps/client.js

@@ -1,32 +1,27 @@
 import { CompositionClient } from "../../../../client.js";
-import { ZStepOutputResponse, ZWorkflowRunStep, } from "../../../../types.js";
+import { ZStepOutputResponse, ZStepOutputsBatchResponse, ZWorkflowRunStep, ZWorkflowRun, } from "../../../../types.js";
 import * as z from "zod";
 /**
  * Workflow Run Steps API client for accessing step-level outputs.
  *
- * Usage: `client.workflows.runs.steps.get(runId, nodeId)` or `client.workflows.runs.steps.list(runId)`
+ * Usage: `client.workflows.runs.steps.get(runId, nodeId)` or `client.workflows.runs.steps.getMany(runId, nodeIds)`
  */
 export default class APIWorkflowRunSteps extends CompositionClient {
     constructor(client) {
         super(client);
     }
     /**
-     * Get the full output data for a specific step in a workflow run.
-     *
-     * @param runId - The ID of the workflow run
-     * @param nodeId - The ID of the node/step to get output for
-     * @param options - Optional request options
-     * @returns The step output with handle outputs and inputs
+     * Get step status and handle data for a specific step in a workflow run.
      *
      * @example
      * ```typescript
      * const step = await client.workflows.runs.steps.get("run_abc123", "extract-node-1");
-     * console.log(`Step status: ${step.status}, output:`, step.output);
+     * const data = step.handle_outputs?.["output-json-0"]?.data;
      * ```
      */
     async get(runId, nodeId, options) {
         return this._fetchJson(ZStepOutputResponse, {
-            url: `/v1/workflows/runs/${runId}/steps/${nodeId}`,
+            url: `/workflows/runs/${runId}/steps/${nodeId}`,
             method: "GET",
             params: options?.params,
             headers: options?.headers,
@@ -35,10 +30,6 @@ export default class APIWorkflowRunSteps extends CompositionClient {
     /**
      * List all persisted step documents for a workflow run.
      *
-     * @param runId - The ID of the workflow run
-     * @param options - Optional request options
-     * @returns All step documents for the run
-     *
      * @example
      * ```typescript
      * const steps = await client.workflows.runs.steps.list("run_abc123");
@@ -49,10 +40,67 @@ export default class APIWorkflowRunSteps extends CompositionClient {
      */
     async list(runId, options) {
         return this._fetchJson(z.array(ZWorkflowRunStep), {
-            url: `/v1/workflows/runs/${runId}/steps`,
+            url: `/workflows/runs/${runId}/steps`,
             method: "GET",
             params: options?.params,
             headers: options?.headers,
         });
     }
+    /**
+     * Batch-get step outputs for multiple nodes in a single request.
+     *
+     * @param runId - The workflow run ID
+     * @param nodeIds - List of node IDs to fetch outputs for
+     * @returns Step outputs keyed by node ID
+     *
+     * @example
+     * ```typescript
+     * const batch = await client.workflows.runs.steps.getMany("run_abc123", ["extract-1", "classifier-1"]);
+     * console.log(batch.outputs["extract-1"]?.handle_outputs);
+     * ```
+     */
+    async getMany(runId, nodeIds, options) {
+        return this._fetchJson(ZStepOutputsBatchResponse, {
+            url: `/workflows/runs/${runId}/steps/batch`,
+            method: "POST",
+            body: { node_ids: nodeIds, ...(options?.body || {}) },
+            params: options?.params,
+            headers: options?.headers,
+        });
+    }
+    async get_many(runId, nodeIds, options) {
+        return this.getMany(runId, nodeIds, options);
+    }
+    /**
+     * Fetch outputs for all steps in a workflow run in one call.
+     *
+     * Internally fetches the run to discover step node IDs, then batch-fetches all outputs.
+     *
+     * @param runId - The workflow run ID
+     * @returns Step outputs keyed by node ID
+     *
+     * @example
+     * ```typescript
+     * const allOutputs = await client.workflows.runs.steps.getAll("run_abc123");
+     * console.log(allOutputs.outputs["extract-1"]?.handle_outputs);
+     * ```
+     */
+    async getAll(run, options) {
+        const workflowRun = typeof run === "string"
+            ? await this._fetchJson(ZWorkflowRun, {
+                url: `/workflows/runs/${run}`,
+                method: "GET",
+                params: options?.params,
+                headers: options?.headers,
+            })
+            : run;
+        const nodeIds = workflowRun.steps.map((s) => s.node_id);
+        if (nodeIds.length === 0) {
+            return { outputs: {} };
+        }
+        return this.getMany(workflowRun.id, nodeIds, options);
+    }
+    async get_all(run, options) {
+        return this.getAll(run, options);
+    }
 }

package/dist/client.d.ts

@@ -5,7 +5,7 @@ type FetchParams = {
     params?: Record<string, any>;
     headers?: Record<string, any>;
     bodyMime?: "application/json" | "multipart/form-data";
-    body?: Record<string, any>;
+    body?: Record<string, any> | unknown[];
     auth?: string[];
 };
 export declare class AbstractClient {
@@ -18,6 +18,8 @@ export declare class CompositionClient extends AbstractClient {
     protected _client: AbstractClient;
     constructor(client: AbstractClient);
     protected _fetch(params: FetchParams): Promise<Response>;
+    private _installPrepareMethods;
+    protected _capturePreparedRequest(methodName: string, args: unknown[]): Promise<FetchParams>;
 }
 export declare class APIError extends Error {
     status: number;
@@ -50,7 +52,7 @@ export declare class FetcherClient extends AbstractClient {
         params?: Record<string, any>;
         headers?: Record<string, any>;
         bodyMime?: "application/json" | "multipart/form-data";
-        body?: Record<string, any>;
+        body?: Record<string, any> | unknown[];
     }): Promise<Response>;
     /**
      * Verify the signature of a webhook event.

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}