@trigger.dev/core 4.2.0 → 4.3.1

package/dist/esm/v3/apiClient/errors.d.ts

@@ -52,3 +52,28 @@ export declare class ApiSchemaValidationError extends ApiError {
         headers: APIHeaders | undefined;
     });
 }
+/**
+ * Error thrown when a batch stream completes but the batch was not sealed.
+ * This indicates that not all expected items were received by the server.
+ * The client should retry sending all items, or investigate the mismatch.
+ */
+export declare class BatchNotSealedError extends Error {
+    readonly name = "BatchNotSealedError";
+    /** The batch ID that was not sealed */
+    readonly batchId: string;
+    /** Number of items currently enqueued on the server */
+    readonly enqueuedCount: number;
+    /** Number of items expected to complete the batch */
+    readonly expectedCount: number;
+    /** Number of items accepted in this request */
+    readonly itemsAccepted: number;
+    /** Number of items deduplicated in this request */
+    readonly itemsDeduplicated: number;
+    constructor(options: {
+        batchId: string;
+        enqueuedCount: number;
+        expectedCount: number;
+        itemsAccepted: number;
+        itemsDeduplicated: number;
+    });
+}

package/dist/esm/v3/apiClient/errors.js

@@ -130,6 +130,33 @@ export class ApiSchemaValidationError extends ApiError {
         this.rawBody = rawBody;
     }
 }
+/**
+ * Error thrown when a batch stream completes but the batch was not sealed.
+ * This indicates that not all expected items were received by the server.
+ * The client should retry sending all items, or investigate the mismatch.
+ */
+export class BatchNotSealedError extends Error {
+    name = "BatchNotSealedError";
+    /** The batch ID that was not sealed */
+    batchId;
+    /** Number of items currently enqueued on the server */
+    enqueuedCount;
+    /** Number of items expected to complete the batch */
+    expectedCount;
+    /** Number of items accepted in this request */
+    itemsAccepted;
+    /** Number of items deduplicated in this request */
+    itemsDeduplicated;
+    constructor(options) {
+        const message = `Batch ${options.batchId} was not sealed: received ${options.enqueuedCount} of ${options.expectedCount} expected items (accepted: ${options.itemsAccepted}, deduplicated: ${options.itemsDeduplicated})`;
+        super(message);
+        this.batchId = options.batchId;
+        this.enqueuedCount = options.enqueuedCount;
+        this.expectedCount = options.expectedCount;
+        this.itemsAccepted = options.itemsAccepted;
+        this.itemsDeduplicated = options.itemsDeduplicated;
+    }
+}
 function castToError(err) {
     if (err instanceof Error)
         return err;

package/dist/esm/v3/apiClient/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/v3/apiClient/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,MAAM,CAAqB;IAC3B,OAAO,CAAyB;IAChC,KAAK,CAAqB;IAE1B,IAAI,CAA4B;IAChC,KAAK,CAA4B;IACjC,IAAI,CAAqB;IAElC,YACE,MAA0B,EAC1B,KAAyB,EACzB,OAA2B,EAC3B,OAA+B;QAE/B,KAAK,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,MAAM,IAAI,GAAG,KAA4B,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAEO,MAAM,CAAC,WAAW,CAAC,MAA0B,EAAE,KAAU,EAAE,OAA2B;QAC5F,MAAM,YAAY,GAAG,KAAK,EAAE,OAAO;YACjC,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;gBACjC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;YACjC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;gBAC3B,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;oBACvB,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;YACtB,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;QAChC,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,GAAG,MAAM,wBAAwB,CAAC;QAC3C,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,0BAA0B,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,QAAQ,CACb,MAA0B,EAC1B,aAAiC,EACjC,OAA2B,EAC3B,OAA+B;QAE/B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,KAAK,GAAI,aAAqC,EAAE,CAAC,OAAO,CAAC,CAAC;QAEhE,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,wBAAwB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,OAAO,IAAI,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YAClB,OAAO,IAAI,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC5B,MAAM,GAAc,SAAS,CAAC;IAEhD,YAAY,EAAE,OAAO,EAAE,KAAK,EAAmD;QAC7E,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,IAAI,mBAAmB,EAAE,SAAS,CAAC,CAAC;QACvE,gEAAgE;QAChE,aAAa;QACb,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IACzB,MAAM,GAAQ,GAAG,CAAC;CACrC;AAED,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC7B,MAAM,GAAQ,GAAG,CAAC;CACrC;AAED,MAAM,OAAO,qBAAsB,SAAQ,QAAQ;IAC/B,MAAM,GAAQ,GAAG,CAAC;CACrC;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACvB,MAAM,GAAQ,GAAG,CAAC;CACrC;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACvB,MAAM,GAAQ,GAAG,CAAC;CACrC;AAED,MAAM,OAAO,wBAAyB,SAAQ,QAAQ;IAClC,MAAM,GAAQ,GAAG,CAAC;CACrC;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IACxB,MAAM,GAAQ,GAAG,CAAC;IAEpC,IAAI,sBAAsB;QACxB,0FAA0F;QAC1F,MAAM,kBAAkB,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAErE,IAAI,OAAO,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YAC3C,MAAM,gBAAgB,GAAG,QAAQ,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;YAE1D,IAAI,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,2DAA2D;YAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC;QAED,OAAO;IACT,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;CAAG;AAEpD,MAAM,OAAO,wBAAyB,SAAQ,QAAQ;IAClC,MAAM,GAAQ,GAAG,CAAC;IAC3B,OAAO,CAAM;IAEtB,YAAY,EACV,OAAO,EACP,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,GAOR;QACC,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,IAAI,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAClE,gEAAgE;QAChE,aAAa;QACb,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAE9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,SAAS,WAAW,CAAC,GAAQ;IAC3B,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC;IACrC,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/v3/apiClient/errors.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/apiClient/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { AddTagsRequestBody, ApiDeploymentListOptions, BatchTaskRunExecutionResult, BatchTriggerTaskV3RequestBody, CompleteWaitpointTokenRequestBody, CreateEnvironmentVariableRequestBody, CreateScheduleOptions, CreateWaitpointTokenRequestBody, CreateWaitpointTokenResponseBody, ListQueueOptions, ListRunResponseItem, ListScheduleOptions, RescheduleRunRequestBody, RetrieveQueueParam, TaskRunExecutionResult, TriggerTaskRequestBody, UpdateEnvironmentVariableRequestBody, UpdateMetadataRequestBody, UpdateScheduleOptions, WaitForDurationRequestBody, WaitpointTokenItem } from "../schemas/index.js";
+import { AddTagsRequestBody, ApiDeploymentListOptions, BatchItemNDJSON, BatchTaskRunExecutionResult, BatchTriggerTaskV3RequestBody, CompleteWaitpointTokenRequestBody, CreateBatchRequestBody, CreateBatchResponse, CreateEnvironmentVariableRequestBody, CreateScheduleOptions, CreateWaitpointTokenRequestBody, CreateWaitpointTokenResponseBody, ListQueueOptions, ListRunResponseItem, ListScheduleOptions, RescheduleRunRequestBody, RetrieveQueueParam, StreamBatchItemsResponse, TaskRunExecutionResult, TriggerTaskRequestBody, UpdateEnvironmentVariableRequestBody, UpdateMetadataRequestBody, UpdateScheduleOptions, WaitForDurationRequestBody, WaitpointTokenItem } from "../schemas/index.js";
 import { AsyncIterableStream } from "../streams/asyncIterableStream.js";
 import { AnyRunTypes, TriggerJwtOptions } from "../types/tasks.js";
 import { Prettify } from "../types/utils.js";
@@ -10,6 +10,9 @@ import { ApiClientConfiguration } from "../apiClientManager-api.js";
 export type CreateWaitpointTokenResponse = Prettify<CreateWaitpointTokenResponseBody & {
     publicAccessToken: string;
 }>;
+export type CreateBatchApiResponse = Prettify<CreateBatchResponse & {
+    publicAccessToken: string;
+}>;
 export type { CreateEnvironmentVariableParams, ImportEnvironmentVariablesParams, SubscribeToRunsQueryParams, UpdateEnvironmentVariableParams, RealtimeRunSkipColumns, };
 export type ClientTriggerOptions = {
     spanParentAsLink?: boolean;
@@ -55,6 +58,43 @@ export declare class ApiClient {
         id: string;
         runCount: number;
     }>;
+    /**
+     * Phase 1 of 2-phase batch API: Create a batch
+     *
+     * Creates a new batch and returns its ID. For batchTriggerAndWait,
+     * the parent run is blocked immediately on batch creation.
+     *
+     * @param body - The batch creation parameters
+     * @param clientOptions - Options for trace context handling
+     * @param clientOptions.spanParentAsLink - If true, child runs will have separate trace IDs with a link to parent
+     * @param requestOptions - Optional request options
+     * @returns The created batch with ID and metadata
+     */
+    createBatch(body: CreateBatchRequestBody, clientOptions?: ClientTriggerOptions, requestOptions?: TriggerRequestOptions): Promise<{
+        publicAccessToken: string;
+        id: string;
+        isCached: boolean;
+        runCount: number;
+        idempotencyKey?: string | undefined;
+    }>;
+    /**
+     * Phase 2 of 2-phase batch API: Stream batch items
+     *
+     * Streams batch items as NDJSON to the server. Each item is enqueued
+     * as it arrives. The batch is automatically sealed when the stream completes.
+     *
+     * Includes automatic retry with exponential backoff. Since items are deduplicated
+     * by index on the server, retrying the entire stream is safe.
+     *
+     * Uses ReadableStream.tee() for retry capability without buffering all items
+     * upfront - only items consumed before a failure are buffered for retry.
+     *
+     * @param batchId - The batch ID from createBatch
+     * @param items - Array or async iterable of batch items
+     * @param requestOptions - Optional request options
+     * @returns Summary of items accepted and deduplicated
+     */
+    streamBatchItems(batchId: string, items: BatchItemNDJSON[] | AsyncIterable<BatchItemNDJSON>, requestOptions?: ApiRequestOptions): Promise<StreamBatchItemsResponse>;
     createUploadPayloadUrl(filename: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         presignedUrl: string;
     }>;
@@ -240,6 +280,9 @@ export declare class ApiClient {
     cancelRun(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         id: string;
     }>;
+    resetIdempotencyKey(taskIdentifier: string, idempotencyKey: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+    }>;
     rescheduleRun(runId: string, body: RescheduleRunRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
         status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
         id: string;
@@ -842,12 +885,21 @@ export declare class ApiClient {
     }>;
     generateJWTClaims(requestOptions?: ZodFetchOptions): Promise<Record<string, any>>;
     retrieveBatch(batchId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        status: "COMPLETED" | "PENDING";
+        status: "COMPLETED" | "PENDING" | "PROCESSING" | "PARTIAL_FAILED" | "ABORTED";
         id: string;
         createdAt: Date;
         updatedAt: Date;
         runs: string[];
         runCount: number;
+        processing: {
+            errors: {
+                error: string;
+                taskIdentifier: string;
+                index: number;
+                errorCode?: string | undefined;
+            }[];
+            completedAt?: Date | undefined;
+        };
         idempotencyKey?: string | undefined;
     }>;
 }

package/dist/esm/v3/apiClient/index.js

@@ -1,10 +1,11 @@
 import { z } from "zod";
 import { VERSION } from "../../version.js";
 import { generateJWT } from "../jwt.js";
-import { ApiDeploymentListResponseItem, AppendToStreamResponseBody, BatchTaskRunExecutionResult, BatchTriggerTaskV3Response, CanceledRunResponse, CompleteWaitpointTokenResponseBody, CreateStreamResponseBody, CreateUploadPayloadUrlResponseBody, CreateWaitpointTokenResponseBody, DeletedScheduleObject, EnvironmentVariableResponseBody, EnvironmentVariableWithSecret, ListRunResponseItem, QueueItem, ReplayRunResponse, RetrieveBatchV2Response, RetrieveRunResponse, RetrieveRunTraceResponseBody, ScheduleObject, TaskRunExecutionResult, TriggerTaskResponse, UpdateMetadataResponseBody, WaitForDurationResponseBody, WaitForWaitpointTokenResponseBody, WaitpointRetrieveTokenResponse, WaitpointTokenItem, } from "../schemas/index.js";
+import { ApiDeploymentListResponseItem, AppendToStreamResponseBody, BatchTaskRunExecutionResult, BatchTriggerTaskV3Response, CanceledRunResponse, CompleteWaitpointTokenResponseBody, CreateBatchResponse, CreateStreamResponseBody, CreateUploadPayloadUrlResponseBody, CreateWaitpointTokenResponseBody, DeletedScheduleObject, EnvironmentVariableResponseBody, EnvironmentVariableWithSecret, ListRunResponseItem, QueueItem, ReplayRunResponse, ResetIdempotencyKeyResponse, RetrieveBatchV2Response, RetrieveRunResponse, RetrieveRunTraceResponseBody, ScheduleObject, StreamBatchItemsResponse, TaskRunExecutionResult, TriggerTaskResponse, UpdateMetadataResponseBody, WaitForDurationResponseBody, WaitForWaitpointTokenResponseBody, WaitpointRetrieveTokenResponse, WaitpointTokenItem, } from "../schemas/index.js";
 import { taskContext } from "../task-context-api.js";
 import { isRequestOptions, zodfetch, zodfetchCursorPage, zodfetchOffsetLimitPage, } from "./core.js";
-import { ApiError } from "./errors.js";
+import { ApiConnectionError, ApiError, BatchNotSealedError } from "./errors.js";
+import { calculateNextRetryDelay } from "../utils/retries.js";
 import { SSEStreamSubscriptionFactory, SSEStreamSubscription, runShapeStream, } from "./runStream.js";
 import { API_VERSION, API_VERSION_HEADER_NAME } from "./version.js";
 import { getEnvVar } from "../utils/getEnv.js";
@@ -132,6 +133,165 @@ export class ApiClient {
             };
         });
     }
+    /**
+     * Phase 1 of 2-phase batch API: Create a batch
+     *
+     * Creates a new batch and returns its ID. For batchTriggerAndWait,
+     * the parent run is blocked immediately on batch creation.
+     *
+     * @param body - The batch creation parameters
+     * @param clientOptions - Options for trace context handling
+     * @param clientOptions.spanParentAsLink - If true, child runs will have separate trace IDs with a link to parent
+     * @param requestOptions - Optional request options
+     * @returns The created batch with ID and metadata
+     */
+    createBatch(body, clientOptions, requestOptions) {
+        return zodfetch(CreateBatchResponse, `${this.baseUrl}/api/v3/batches`, {
+            method: "POST",
+            headers: this.#getHeaders(clientOptions?.spanParentAsLink ?? false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions))
+            .withResponse()
+            .then(async ({ data, response }) => {
+            const claimsHeader = response.headers.get("x-trigger-jwt-claims");
+            const claims = claimsHeader ? JSON.parse(claimsHeader) : undefined;
+            const jwt = await generateJWT({
+                secretKey: this.accessToken,
+                payload: {
+                    ...claims,
+                    scopes: [`read:batch:${data.id}`],
+                },
+                expirationTime: requestOptions?.publicAccessToken?.expirationTime ?? "1h",
+            });
+            return {
+                ...data,
+                publicAccessToken: jwt,
+            };
+        });
+    }
+    /**
+     * Phase 2 of 2-phase batch API: Stream batch items
+     *
+     * Streams batch items as NDJSON to the server. Each item is enqueued
+     * as it arrives. The batch is automatically sealed when the stream completes.
+     *
+     * Includes automatic retry with exponential backoff. Since items are deduplicated
+     * by index on the server, retrying the entire stream is safe.
+     *
+     * Uses ReadableStream.tee() for retry capability without buffering all items
+     * upfront - only items consumed before a failure are buffered for retry.
+     *
+     * @param batchId - The batch ID from createBatch
+     * @param items - Array or async iterable of batch items
+     * @param requestOptions - Optional request options
+     * @returns Summary of items accepted and deduplicated
+     */
+    async streamBatchItems(batchId, items, requestOptions) {
+        // Convert input to ReadableStream for uniform handling and tee() support
+        const stream = createNdjsonStream(items);
+        const retryOptions = {
+            ...DEFAULT_STREAM_BATCH_RETRY_OPTIONS,
+            ...requestOptions?.retry,
+        };
+        return this.#streamBatchItemsWithRetry(batchId, stream, retryOptions);
+    }
+    async #streamBatchItemsWithRetry(batchId, stream, retryOptions, attempt = 1) {
+        const headers = this.#getHeaders(false);
+        headers["Content-Type"] = "application/x-ndjson";
+        // Tee the stream: one branch for this attempt, one for potential retry
+        // tee() internally buffers data consumed from one branch for the other,
+        // so we only buffer what's been sent before a failure occurs
+        const [forRequest, forRetry] = stream.tee();
+        try {
+            const response = await fetch(`${this.baseUrl}/api/v3/batches/${batchId}/items`, {
+                method: "POST",
+                headers,
+                body: forRequest,
+                // @ts-expect-error - duplex is required for streaming body but not in types
+                duplex: "half",
+            });
+            if (!response.ok) {
+                const retryResult = shouldRetryStreamBatchItems(response, attempt, retryOptions);
+                if (retryResult.retry) {
+                    // Cancel the request stream before retry to prevent tee() from buffering
+                    await forRequest.cancel();
+                    await sleep(retryResult.delay);
+                    // Use the backup stream for retry
+                    return this.#streamBatchItemsWithRetry(batchId, forRetry, retryOptions, attempt + 1);
+                }
+                // Not retrying - cancel the backup stream
+                await forRetry.cancel();
+                const errText = await response.text().catch((e) => e.message);
+                let errJSON;
+                try {
+                    errJSON = JSON.parse(errText);
+                }
+                catch {
+                    // ignore
+                }
+                const errMessage = errJSON ? undefined : errText;
+                const responseHeaders = Object.fromEntries(response.headers.entries());
+                throw ApiError.generate(response.status, errJSON, errMessage, responseHeaders);
+            }
+            const result = await response.json();
+            const parsed = StreamBatchItemsResponse.safeParse(result);
+            if (!parsed.success) {
+                // Cancel backup stream since we're throwing
+                await forRetry.cancel();
+                throw new Error(`Invalid response from server for batch ${batchId}: ${parsed.error.message}`);
+            }
+            // Check if the batch was sealed
+            if (!parsed.data.sealed) {
+                // Not all items were received - treat as retryable condition
+                const delay = calculateNextRetryDelay(retryOptions, attempt);
+                if (delay) {
+                    // Cancel the request stream before retry to prevent tee() from buffering
+                    await forRequest.cancel();
+                    // Retry with the backup stream
+                    await sleep(delay);
+                    return this.#streamBatchItemsWithRetry(batchId, forRetry, retryOptions, attempt + 1);
+                }
+                // No more retries - cancel backup stream and throw descriptive error
+                await forRetry.cancel();
+                throw new BatchNotSealedError({
+                    batchId,
+                    enqueuedCount: parsed.data.enqueuedCount ?? 0,
+                    expectedCount: parsed.data.expectedCount ?? 0,
+                    itemsAccepted: parsed.data.itemsAccepted,
+                    itemsDeduplicated: parsed.data.itemsDeduplicated,
+                });
+            }
+            // Success - cancel the backup stream to release resources
+            await forRetry.cancel();
+            return parsed.data;
+        }
+        catch (error) {
+            // Don't retry BatchNotSealedError (retries already exhausted)
+            if (error instanceof BatchNotSealedError) {
+                throw error;
+            }
+            // Don't retry ApiErrors (already handled above with backup stream cancelled)
+            if (error instanceof ApiError) {
+                throw error;
+            }
+            // Retry connection errors using the backup stream
+            const delay = calculateNextRetryDelay(retryOptions, attempt);
+            if (delay) {
+                // Cancel the request stream before retry to prevent tee() from buffering
+                await forRequest.cancel();
+                await sleep(delay);
+                return this.#streamBatchItemsWithRetry(batchId, forRetry, retryOptions, attempt + 1);
+            }
+            // No more retries - cancel the backup stream
+            await forRetry.cancel();
+            // Wrap in a more descriptive error
+            const cause = error instanceof Error ? error : new Error(String(error));
+            throw new ApiConnectionError({
+                cause,
+                message: `Failed to stream batch items for batch ${batchId}: ${cause.message}`,
+            });
+        }
+    }
     createUploadPayloadUrl(filename, requestOptions) {
         return zodfetch(CreateUploadPayloadUrlResponseBody, `${this.baseUrl}/api/v1/packets/${filename}`, {
             method: "PUT",
@@ -195,6 +355,13 @@ export class ApiClient {
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions) {
+        return zodfetch(ResetIdempotencyKeyResponse, `${this.baseUrl}/api/v1/idempotencyKeys/${encodeURIComponent(idempotencyKey)}/reset`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify({ taskIdentifier }),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
     rescheduleRun(runId, body, requestOptions) {
         return zodfetch(RetrieveRunResponse, `${this.baseUrl}/api/v1/runs/${runId}/reschedule`, {
             method: "POST",
@@ -721,6 +888,119 @@ function createSearchQueryForListWaitpointTokens(query) {
     }
     return searchParams;
 }
+// ============================================================================
+// Stream Batch Items Retry Helpers
+// ============================================================================
+/**
+ * Default retry options for streaming batch items.
+ * Uses higher values than the default zodfetch retry since batch operations
+ * are more expensive to repeat from scratch.
+ */
+const DEFAULT_STREAM_BATCH_RETRY_OPTIONS = {
+    maxAttempts: 5,
+    factor: 2,
+    minTimeoutInMs: 1000,
+    maxTimeoutInMs: 30_000,
+    randomize: true,
+};
+/**
+ * Determines if a failed stream batch items request should be retried.
+ * Follows similar logic to zodfetch's shouldRetry but specific to batch streaming.
+ */
+function shouldRetryStreamBatchItems(response, attempt, retryOptions) {
+    function shouldRetryForOptions() {
+        const delay = calculateNextRetryDelay(retryOptions, attempt);
+        if (delay) {
+            return { retry: true, delay };
+        }
+        return { retry: false };
+    }
+    // Check x-should-retry header - server can explicitly control retry behavior
+    const shouldRetryHeader = response.headers.get("x-should-retry");
+    if (shouldRetryHeader === "true")
+        return shouldRetryForOptions();
+    if (shouldRetryHeader === "false")
+        return { retry: false };
+    // Retry on request timeouts
+    if (response.status === 408)
+        return shouldRetryForOptions();
+    // Retry on lock timeouts
+    if (response.status === 409)
+        return shouldRetryForOptions();
+    // Retry on rate limits with special handling for Retry-After
+    if (response.status === 429) {
+        if (attempt >= retryOptions.maxAttempts) {
+            return { retry: false };
+        }
+        // x-ratelimit-reset is the unix timestamp in milliseconds when the rate limit will reset
+        const resetAtUnixEpochMs = response.headers.get("x-ratelimit-reset");
+        if (resetAtUnixEpochMs) {
+            const resetAtUnixEpoch = parseInt(resetAtUnixEpochMs, 10);
+            const delay = resetAtUnixEpoch - Date.now() + Math.floor(Math.random() * 1000);
+            if (delay > 0) {
+                return { retry: true, delay };
+            }
+        }
+        // Fall back to Retry-After header (seconds)
+        const retryAfter = response.headers.get("retry-after");
+        if (retryAfter) {
+            const retryAfterSeconds = parseInt(retryAfter, 10);
+            if (!isNaN(retryAfterSeconds)) {
+                return { retry: true, delay: retryAfterSeconds * 1000 };
+            }
+        }
+        return shouldRetryForOptions();
+    }
+    // Retry on server errors (5xx)
+    if (response.status >= 500)
+        return shouldRetryForOptions();
+    // Don't retry client errors (4xx) except those handled above
+    return { retry: false };
+}
+/**
+ * Simple sleep utility for retry delays.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ============================================================================
+// NDJSON Stream Helpers
+// ============================================================================
+/**
+ * Creates a ReadableStream that emits NDJSON (newline-delimited JSON) from items.
+ * Handles both arrays and async iterables for streaming large batches.
+ */
+function createNdjsonStream(items) {
+    const encoder = new TextEncoder();
+    // Check if items is an array
+    if (Array.isArray(items)) {
+        let index = 0;
+        return new ReadableStream({
+            pull(controller) {
+                if (index >= items.length) {
+                    controller.close();
+                    return;
+                }
+                const item = items[index++];
+                const line = JSON.stringify(item) + "\n";
+                controller.enqueue(encoder.encode(line));
+            },
+        });
+    }
+    // Handle async iterable
+    const iterator = items[Symbol.asyncIterator]();
+    return new ReadableStream({
+        async pull(controller) {
+            const { value, done } = await iterator.next();
+            if (done) {
+                controller.close();
+                return;
+            }
+            const line = JSON.stringify(value) + "\n";
+            controller.enqueue(encoder.encode(line));
+        },
+    });
+}
 export function mergeRequestOptions(defaultOptions, options) {
     if (!options) {
         return defaultOptions;