@trigger.dev/sdk 4.3.2 → 4.4.0

package/dist/commonjs/v3/hooks.d.ts

@@ -1,5 +1,5 @@
 import { type AnyOnStartHookFunction, type TaskStartHookParams, type OnStartHookFunction, type AnyOnFailureHookFunction, type AnyOnSuccessHookFunction, type AnyOnCompleteHookFunction, type TaskCompleteResult, type AnyOnWaitHookFunction, type AnyOnResumeHookFunction, type AnyOnCatchErrorHookFunction, type AnyOnMiddlewareHookFunction, type AnyOnCancelHookFunction, type AnyOnStartAttemptHookFunction } from "@trigger.dev/core/v3";
-export type { AnyOnStartHookFunction, TaskStartHookParams, OnStartHookFunction, AnyOnFailureHookFunction, AnyOnSuccessHookFunction, AnyOnCompleteHookFunction, TaskCompleteResult, AnyOnWaitHookFunction, AnyOnResumeHookFunction, AnyOnCatchErrorHookFunction, AnyOnMiddlewareHookFunction, AnyOnCancelHookFunction, };
+export type { AnyOnStartHookFunction, AnyOnStartAttemptHookFunction, TaskStartHookParams, OnStartHookFunction, AnyOnFailureHookFunction, AnyOnSuccessHookFunction, AnyOnCompleteHookFunction, TaskCompleteResult, AnyOnWaitHookFunction, AnyOnResumeHookFunction, AnyOnCatchErrorHookFunction, AnyOnMiddlewareHookFunction, AnyOnCancelHookFunction, };
 export declare function onStart(name: string, fn: AnyOnStartHookFunction): void;
 export declare function onStart(fn: AnyOnStartHookFunction): void;
 export declare function onStartAttempt(name: string, fn: AnyOnStartAttemptHookFunction): void;

package/dist/commonjs/v3/hooks.js.map

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

package/dist/commonjs/v3/index.d.ts

@@ -17,6 +17,7 @@ export * from "./otel.js";
 export * from "./schemas.js";
 export * from "./heartbeats.js";
 export * from "./streams.js";
+export * from "./query.js";
 export type { Context };
 import type { Context } from "./shared.js";
 import type { ApiClientConfiguration } from "@trigger.dev/core/v3";

package/dist/commonjs/v3/index.js

@@ -49,6 +49,7 @@ __exportStar(require("./otel.js"), exports);
 __exportStar(require("./schemas.js"), exports);
 __exportStar(require("./heartbeats.js"), exports);
 __exportStar(require("./streams.js"), exports);
+__exportStar(require("./query.js"), exports);
 var v3_1 = require("@trigger.dev/core/v3");
 Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return v3_1.ApiError; } });
 Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return v3_1.AuthenticationError; } });

package/dist/commonjs/v3/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,uCAAsD;AAA7C,iGAAA,KAAK,OAAA;AACd,yCAAuD;AAA9C,kGAAA,KAAK,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AACjC,6CAA2B;AAC3B,6CAA2B;AAC3B,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,uDAAqC;AACrC,4CAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAC7B,kDAAgC;AAChC,+CAA6B;AAS7B,2CAe8B;AAd5B,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,mGAAA,aAAa,OAAA;AACb,yGAAA,mBAAmB,OAAA;AACnB,mGAAA,aAAa,OAAA;AACb,2GAAA,qBAAqB,OAAA;AACrB,oGAAA,cAAc,OAAA;AACd,8GAAA,wBAAwB,OAAA;AACxB,uGAAA,iBAAiB,OAAA;AACjB,sGAAA,gBAAgB,OAAA;AAChB,4GAAA,sBAAsB,OAAA;AACtB,4FAAA,MAAM,OAAA;AAIR,qCASmB;AARjB,+FAAA,IAAI,OAAA;AASN,kEAAkD;AAClD,wDAAwC;AACxC,sDAAsC;AAGtC,qCAA4C;AAAnC,oGAAA,SAAS,OAAA;AAAE,+FAAA,IAAI,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,8CAA4B;AAC5B,uCAAsD;AAA7C,iGAAA,KAAK,OAAA;AACd,yCAAuD;AAA9C,kGAAA,KAAK,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AACjC,6CAA2B;AAC3B,6CAA2B;AAC3B,4CAA0B;AAC1B,iDAA+B;AAC/B,6CAA2B;AAC3B,uDAAqC;AACrC,4CAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,+CAA6B;AAC7B,kDAAgC;AAChC,+CAA6B;AAC7B,6CAA2B;AAS3B,2CAe8B;AAd5B,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,mGAAA,aAAa,OAAA;AACb,yGAAA,mBAAmB,OAAA;AACnB,mGAAA,aAAa,OAAA;AACb,2GAAA,qBAAqB,OAAA;AACrB,oGAAA,cAAc,OAAA;AACd,8GAAA,wBAAwB,OAAA;AACxB,uGAAA,iBAAiB,OAAA;AACjB,sGAAA,gBAAgB,OAAA;AAChB,4GAAA,sBAAsB,OAAA;AACtB,4FAAA,MAAM,OAAA;AAIR,qCASmB;AARjB,+FAAA,IAAI,OAAA;AASN,kEAAkD;AAClD,wDAAwC;AACxC,sDAAsC;AAGtC,qCAA4C;AAAnC,oGAAA,SAAS,OAAA;AAAE,+FAAA,IAAI,OAAA"}

package/dist/commonjs/v3/query.d.ts

@@ -0,0 +1,112 @@
+import type { ApiRequestOptions, Prettify } from "@trigger.dev/core/v3";
+export type { QueryTable, RunsTableRow, RunFriendlyStatus } from "@trigger.dev/core/v3";
+export type QueryScope = "environment" | "project" | "organization";
+export type QueryFormat = "json" | "csv";
+/**
+ * Options for executing a TRQL query
+ */
+export type QueryOptions = {
+    /**
+     * The scope of the query - determines what data is accessible
+     * - "environment": Current environment only (default)
+     * - "project": All environments in the project
+     * - "organization": All projects in the organization
+     *
+     * @default "environment"
+     */
+    scope?: QueryScope;
+    /**
+     * Time period to query (e.g., "7d", "30d", "1h")
+     * Cannot be used with `from` or `to`
+     */
+    period?: string;
+    /**
+     * Start of time range as a Date object or Unix timestamp in milliseconds.
+     * Must be used with `to`.
+     */
+    from?: Date | number;
+    /**
+     * End of time range as a Date object or Unix timestamp in milliseconds.
+     * Must be used with `from`.
+     */
+    to?: Date | number;
+    /**
+     * Response format
+     * - "json": Returns structured data (default)
+     * - "csv": Returns CSV string
+     *
+     * @default "json"
+     */
+    format?: QueryFormat;
+};
+/**
+ * Execute a TRQL query and get the results as a CSV string.
+ *
+ * @param {string} query - The TRQL query string to execute
+ * @param {QueryOptions & { format: "csv" }} options - Query options with `format: "csv"`
+ * @param {ApiRequestOptions} [requestOptions] - Optional API request configuration
+ * @returns A promise resolving to `{ format: "csv", results: string }` where `results` is the raw CSV text
+ *
+ * @example
+ * ```typescript
+ * const csvResult = await query.execute(
+ *   "SELECT run_id, status, triggered_at FROM runs",
+ *   { format: "csv", period: "7d" }
+ * );
+ * const lines = csvResult.results.split('\n');
+ * ```
+ */
+declare function execute(query: string, options: QueryOptions & {
+    format: "csv";
+}, requestOptions?: ApiRequestOptions): Promise<{
+    format: "csv";
+    results: string;
+}>;
+/**
+ * Execute a TRQL query and return typed JSON rows.
+ *
+ * @template TRow - The shape of each row in the result set. Use {@link QueryTable} for type-safe column access (e.g. `QueryTable<"runs", "status" | "run_id">`)
+ * @param {string} query - The TRQL query string to execute
+ * @param {QueryOptions} [options] - Optional query configuration
+ * @param {ApiRequestOptions} [requestOptions] - Optional API request configuration
+ * @returns A promise resolving to `{ format: "json", results: Array<TRow> }`
+ *
+ * @example
+ * ```typescript
+ * // Basic query with defaults (environment scope, json format)
+ * const result = await query.execute("SELECT run_id, status FROM runs LIMIT 10");
+ * console.log(result.results); // Array<Record<string, any>>
+ *
+ * // Type-safe query using QueryTable with specific columns
+ * const typedResult = await query.execute<QueryTable<"runs", "run_id" | "status" | "triggered_at">>(
+ *   "SELECT run_id, status, triggered_at FROM runs LIMIT 10"
+ * );
+ * typedResult.results.forEach(row => {
+ *   console.log(row.run_id, row.status); // Fully typed!
+ * });
+ *
+ * // Inline type for aggregation queries
+ * const stats = await query.execute<{ status: string; count: number }>(
+ *   "SELECT status, COUNT(*) as count FROM runs GROUP BY status"
+ * );
+ * stats.results.forEach(row => {
+ *   console.log(row.status, row.count); // Fully type-safe
+ * });
+ *
+ * // Query with a custom time period
+ * const recent = await query.execute(
+ *   "SELECT COUNT(*) as count FROM runs",
+ *   { period: "3d" }
+ * );
+ * console.log(recent.results[0].count);
+ * ```
+ */
+declare function execute<TRow extends Record<string, any> = Record<string, any>>(query: string, options?: Omit<QueryOptions, "format"> | (QueryOptions & {
+    format?: "json";
+}), requestOptions?: ApiRequestOptions): Promise<{
+    format: "json";
+    results: Array<Prettify<TRow>>;
+}>;
+export declare const query: {
+    execute: typeof execute;
+};

package/dist/commonjs/v3/query.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.query = void 0;
+const v3_1 = require("@trigger.dev/core/v3");
+const tracer_js_1 = require("./tracer.js");
+// Implementation
+function execute(query, options, requestOptions) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const from = dateToISOString(options?.from);
+    const to = dateToISOString(options?.to);
+    const $requestOptions = (0, v3_1.mergeRequestOptions)({
+        tracer: tracer_js_1.tracer,
+        name: "query.execute()",
+        icon: "query",
+        attributes: {
+            scope: options?.scope ?? "environment",
+            format: options?.format ?? "json",
+            query,
+            period: options?.period,
+            from,
+            to,
+        },
+    }, requestOptions);
+    return apiClient
+        .executeQuery(query, {
+        scope: options?.scope,
+        period: options?.period,
+        from,
+        to,
+        format: options?.format,
+    }, $requestOptions)
+        .then((response) => {
+        return response;
+    });
+}
+function dateToISOString(date) {
+    if (date === undefined) {
+        return undefined;
+    }
+    if (date instanceof Date) {
+        return date.toISOString();
+    }
+    return new Date(date).toISOString();
+}
+exports.query = {
+    execute,
+};
+//# sourceMappingURL=query.js.map

package/dist/commonjs/v3/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/v3/query.ts"],"names":[],"mappings":";;;AAMA,6CAA6E;AAC7E,2CAAqC;AAqHrC,iBAAiB;AACjB,SAAS,OAAO,CACd,KAAa,EACb,OAAsB,EACtB,cAAkC;IAElC,MAAM,SAAS,GAAG,qBAAgB,CAAC,aAAa,EAAE,CAAC;IAEnD,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,eAAe,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAExC,MAAM,eAAe,GAAG,IAAA,wBAAmB,EACzC;QACE,MAAM,EAAN,kBAAM;QACN,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,OAAO;QACb,UAAU,EAAE;YACV,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,aAAa;YACtC,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,MAAM;YACjC,KAAK;YACL,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,IAAI;YACJ,EAAE;SACH;KACF,EACD,cAAc,CACf,CAAC;IAEF,OAAO,SAAS;SACb,YAAY,CACX,KAAK,EACL;QACE,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,IAAI;QACJ,EAAE;QACF,MAAM,EAAE,OAAO,EAAE,MAAM;KACxB,EACD,eAAe,CAChB;SACA,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACjB,OAAO,QAAQ,CAAC;IAClB,CAAC,CAA2F,CAAC;AACjG,CAAC;AAED,SAAS,eAAe,CAAC,IAA+B;IACtD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;AACtC,CAAC;AAEY,QAAA,KAAK,GAAG;IACnB,OAAO;CACR,CAAC"}

package/dist/commonjs/v3/shared.js

@@ -646,6 +646,7 @@ async function executeBatchTwoPhase(apiClient, items, options, requestOptions) {
             parentRunId: options.parentRunId,
             resumeParentOnCompletion: options.resumeParentOnCompletion,
             idempotencyKey: options.idempotencyKey,
+            idempotencyKeyOptions: options.idempotencyKeyOptions,
         }, { spanParentAsLink: options.spanParentAsLink }, requestOptions);
     }
     catch (error) {
@@ -1037,6 +1038,12 @@ async function* transformSingleTaskBatchItemsStreamForWait(taskIdentifier, items
         const parsedPayload = parsePayload ? await parsePayload(item.payload) : item.payload;
         const payloadPacket = await (0, v3_1.stringifyIO)(parsedPayload);
         const batchItemIdempotencyKey = await (0, v3_1.makeIdempotencyKey)((0, v3_1.flattenIdempotencyKey)([options?.idempotencyKey, `${index}`]));
+        // Process item-specific idempotency key and extract options
+        const itemIdempotencyKey = await (0, v3_1.makeIdempotencyKey)(item.options?.idempotencyKey);
+        const finalIdempotencyKey = itemIdempotencyKey ?? batchItemIdempotencyKey;
+        const idempotencyKeyOptions = itemIdempotencyKey
+            ? (0, v3_1.getIdempotencyKeyOptions)(itemIdempotencyKey)
+            : undefined;
         yield {
             index: index++,
             task: taskIdentifier,
@@ -1057,8 +1064,9 @@ async function* transformSingleTaskBatchItemsStreamForWait(taskIdentifier, items
                 maxAttempts: item.options?.maxAttempts,
                 metadata: item.options?.metadata,
                 maxDuration: item.options?.maxDuration,
-                idempotencyKey: (await (0, v3_1.makeIdempotencyKey)(item.options?.idempotencyKey)) ?? batchItemIdempotencyKey,
+                idempotencyKey: finalIdempotencyKey?.toString(),
                 idempotencyKeyTTL: item.options?.idempotencyKeyTTL ?? options?.idempotencyKeyTTL,
+                idempotencyKeyOptions,
                 machine: item.options?.machine,
                 priority: item.options?.priority,
                 region: item.options?.region,
@@ -1071,6 +1079,11 @@ async function trigger_internal(name, id, payload, parsePayload, options, reques
     const apiClient = v3_1.apiClientManager.clientOrThrow(requestOptions?.clientConfig);
     const parsedPayload = parsePayload ? await parsePayload(payload) : payload;
     const payloadPacket = await (0, v3_1.stringifyIO)(parsedPayload);
+    // Process idempotency key and extract options for storage
+    const processedIdempotencyKey = await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey);
+    const idempotencyKeyOptions = processedIdempotencyKey
+        ? (0, v3_1.getIdempotencyKeyOptions)(processedIdempotencyKey)
+        : undefined;
     const handle = await apiClient.triggerTask(id, {
         payload: payloadPacket.data,
         options: {
@@ -1078,8 +1091,9 @@ async function trigger_internal(name, id, payload, parsePayload, options, reques
             concurrencyKey: options?.concurrencyKey,
             test: v3_1.taskContext.ctx?.run.isTest,
             payloadType: payloadPacket.dataType,
-            idempotencyKey: await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey),
+            idempotencyKey: processedIdempotencyKey?.toString(),
             idempotencyKeyTTL: options?.idempotencyKeyTTL,
+            idempotencyKeyOptions,
             delay: options?.delay,
             ttl: options?.ttl,
             tags: options?.tags,
@@ -1120,6 +1134,12 @@ async function batchTrigger_internal(name, taskIdentifier, items, options, parse
             const parsedPayload = parsePayload ? await parsePayload(item.payload) : item.payload;
             const payloadPacket = await (0, v3_1.stringifyIO)(parsedPayload);
             const batchItemIdempotencyKey = await (0, v3_1.makeIdempotencyKey)((0, v3_1.flattenIdempotencyKey)([options?.idempotencyKey, `${index}`]));
+            // Process item-specific idempotency key and extract options
+            const itemIdempotencyKey = await (0, v3_1.makeIdempotencyKey)(item.options?.idempotencyKey);
+            const finalIdempotencyKey = itemIdempotencyKey ?? batchItemIdempotencyKey;
+            const idempotencyKeyOptions = itemIdempotencyKey
+                ? (0, v3_1.getIdempotencyKeyOptions)(itemIdempotencyKey)
+                : undefined;
             return {
                 index,
                 task: taskIdentifier,
@@ -1139,8 +1159,9 @@ async function batchTrigger_internal(name, taskIdentifier, items, options, parse
                     maxAttempts: item.options?.maxAttempts,
                     metadata: item.options?.metadata,
                     maxDuration: item.options?.maxDuration,
-                    idempotencyKey: (await (0, v3_1.makeIdempotencyKey)(item.options?.idempotencyKey)) ?? batchItemIdempotencyKey,
+                    idempotencyKey: finalIdempotencyKey?.toString(),
                     idempotencyKeyTTL: item.options?.idempotencyKeyTTL ?? options?.idempotencyKeyTTL,
+                    idempotencyKeyOptions,
                     machine: item.options?.machine,
                     priority: item.options?.priority,
                     region: item.options?.region,
@@ -1149,10 +1170,16 @@ async function batchTrigger_internal(name, taskIdentifier, items, options, parse
             };
         }));
         // Execute 2-phase batch
+        // Process batch-level idempotency key
+        const batchIdempotencyKey = await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey);
+        const batchIdempotencyKeyOptions = batchIdempotencyKey
+            ? (0, v3_1.getIdempotencyKeyOptions)(batchIdempotencyKey)
+            : undefined;
         const response = await tracer_js_1.tracer.startActiveSpan(name, async (span) => {
             const result = await executeBatchTwoPhase(apiClient, ndJsonItems, {
                 parentRunId: ctx?.run.id,
-                idempotencyKey: await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey),
+                idempotencyKey: batchIdempotencyKey?.toString(),
+                idempotencyKeyOptions: batchIdempotencyKeyOptions,
                 spanParentAsLink: true, // Fire-and-forget: child runs get separate trace IDs
             }, requestOptions);
             span.setAttribute("batchId", result.id);
@@ -1185,10 +1212,16 @@ async function batchTrigger_internal(name, taskIdentifier, items, options, parse
         const asyncItems = normalizeToAsyncIterable(items);
         const transformedItems = transformSingleTaskBatchItemsStream(taskIdentifier, asyncItems, parsePayload, options, queue);
         // Execute streaming 2-phase batch
+        // Process batch-level idempotency key
+        const streamBatchIdempotencyKey = await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey);
+        const streamBatchIdempotencyKeyOptions = streamBatchIdempotencyKey
+            ? (0, v3_1.getIdempotencyKeyOptions)(streamBatchIdempotencyKey)
+            : undefined;
         const response = await tracer_js_1.tracer.startActiveSpan(name, async (span) => {
             const result = await executeBatchTwoPhaseStreaming(apiClient, transformedItems, {
                 parentRunId: ctx?.run.id,
-                idempotencyKey: await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey),
+                idempotencyKey: streamBatchIdempotencyKey?.toString(),
+                idempotencyKeyOptions: streamBatchIdempotencyKeyOptions,
                 spanParentAsLink: true, // Fire-and-forget: child runs get separate trace IDs
             }, requestOptions);
             span.setAttribute("batchId", result.id);
@@ -1225,6 +1258,11 @@ async function triggerAndWait_internal(name, id, payload, parsePayload, options,
     const apiClient = v3_1.apiClientManager.clientOrThrow(requestOptions?.clientConfig);
     const parsedPayload = parsePayload ? await parsePayload(payload) : payload;
     const payloadPacket = await (0, v3_1.stringifyIO)(parsedPayload);
+    // Process idempotency key and extract options for storage
+    const processedIdempotencyKey = await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey);
+    const idempotencyKeyOptions = processedIdempotencyKey
+        ? (0, v3_1.getIdempotencyKeyOptions)(processedIdempotencyKey)
+        : undefined;
     return await tracer_js_1.tracer.startActiveSpan(name, async (span) => {
         const response = await apiClient.triggerTask(id, {
             payload: payloadPacket.data,
@@ -1242,8 +1280,9 @@ async function triggerAndWait_internal(name, id, payload, parsePayload, options,
                 maxDuration: options?.maxDuration,
                 resumeParentOnCompletion: true,
                 parentRunId: ctx.run.id,
-                idempotencyKey: await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey),
+                idempotencyKey: processedIdempotencyKey?.toString(),
                 idempotencyKeyTTL: options?.idempotencyKeyTTL,
+                idempotencyKeyOptions,
                 machine: options?.machine,
                 priority: options?.priority,
                 region: options?.region,
@@ -1285,6 +1324,12 @@ async function batchTriggerAndWait_internal(name, id, items, parsePayload, optio
             const parsedPayload = parsePayload ? await parsePayload(item.payload) : item.payload;
             const payloadPacket = await (0, v3_1.stringifyIO)(parsedPayload);
             const batchItemIdempotencyKey = await (0, v3_1.makeIdempotencyKey)((0, v3_1.flattenIdempotencyKey)([options?.idempotencyKey, `${index}`]));
+            // Process item-specific idempotency key and extract options
+            const itemIdempotencyKey = await (0, v3_1.makeIdempotencyKey)(item.options?.idempotencyKey);
+            const finalIdempotencyKey = itemIdempotencyKey ?? batchItemIdempotencyKey;
+            const idempotencyKeyOptions = itemIdempotencyKey
+                ? (0, v3_1.getIdempotencyKeyOptions)(itemIdempotencyKey)
+                : undefined;
             return {
                 index,
                 task: id,
@@ -1305,20 +1350,27 @@ async function batchTriggerAndWait_internal(name, id, items, parsePayload, optio
                     maxAttempts: item.options?.maxAttempts,
                     metadata: item.options?.metadata,
                     maxDuration: item.options?.maxDuration,
-                    idempotencyKey: (await (0, v3_1.makeIdempotencyKey)(item.options?.idempotencyKey)) ?? batchItemIdempotencyKey,
+                    idempotencyKey: finalIdempotencyKey?.toString(),
                     idempotencyKeyTTL: item.options?.idempotencyKeyTTL ?? options?.idempotencyKeyTTL,
+                    idempotencyKeyOptions,
                     machine: item.options?.machine,
                     priority: item.options?.priority,
                     region: item.options?.region,
                 },
             };
         }));
+        // Process batch-level idempotency key
+        const batchIdempotencyKey = await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey);
+        const batchIdempotencyKeyOptions = batchIdempotencyKey
+            ? (0, v3_1.getIdempotencyKeyOptions)(batchIdempotencyKey)
+            : undefined;
         return await tracer_js_1.tracer.startActiveSpan(name, async (span) => {
             // Execute 2-phase batch
             const response = await executeBatchTwoPhase(apiClient, ndJsonItems, {
                 parentRunId: ctx.run.id,
                 resumeParentOnCompletion: true,
-                idempotencyKey: await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey),
+                idempotencyKey: batchIdempotencyKey?.toString(),
+                idempotencyKeyOptions: batchIdempotencyKeyOptions,
                 spanParentAsLink: false, // Waiting: child runs share parent's trace ID
             }, requestOptions);
             span.setAttribute("batchId", response.id);
@@ -1353,12 +1405,18 @@ async function batchTriggerAndWait_internal(name, id, items, parsePayload, optio
         // Stream path: convert to AsyncIterable and transform
         const asyncItems = normalizeToAsyncIterable(items);
         const transformedItems = transformSingleTaskBatchItemsStreamForWait(id, asyncItems, parsePayload, options, queue);
+        // Process batch-level idempotency key for streaming path
+        const streamBatchIdempotencyKey = await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey);
+        const streamBatchIdempotencyKeyOptions = streamBatchIdempotencyKey
+            ? (0, v3_1.getIdempotencyKeyOptions)(streamBatchIdempotencyKey)
+            : undefined;
         return await tracer_js_1.tracer.startActiveSpan(name, async (span) => {
             // Execute streaming 2-phase batch
             const response = await executeBatchTwoPhaseStreaming(apiClient, transformedItems, {
                 parentRunId: ctx.run.id,
                 resumeParentOnCompletion: true,
-                idempotencyKey: await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey),
+                idempotencyKey: streamBatchIdempotencyKey?.toString(),
+                idempotencyKeyOptions: streamBatchIdempotencyKeyOptions,
                 spanParentAsLink: false, // Waiting: child runs share parent's trace ID
             }, requestOptions);
             span.setAttribute("batchId", response.id);