@trigger.dev/core 0.0.0-prerelease-20251215135620 → 0.0.0-prerelease-20260120115202

package/dist/esm/v3/schemas/api.d.ts

@@ -740,6 +740,18 @@ export declare const CreateBackgroundWorkerResponse: z.ZodObject<{
 export type CreateBackgroundWorkerResponse = z.infer<typeof CreateBackgroundWorkerResponse>;
 export declare const RunTags: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
 export type RunTags = z.infer<typeof RunTags>;
+/** Stores the original user-provided idempotency key and scope */
+export declare const IdempotencyKeyOptionsSchema: z.ZodObject<{
+    key: z.ZodString;
+    scope: z.ZodEnum<["run", "attempt", "global"]>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    scope: "run" | "attempt" | "global";
+}, {
+    key: string;
+    scope: "run" | "attempt" | "global";
+}>;
+export type IdempotencyKeyOptionsSchema = z.infer<typeof IdempotencyKeyOptionsSchema>;
 export declare const TriggerTaskRequestBody: z.ZodObject<{
     payload: z.ZodAny;
     context: z.ZodAny;
@@ -783,6 +795,17 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         delay: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
         idempotencyKey: z.ZodOptional<z.ZodString>;
         idempotencyKeyTTL: z.ZodOptional<z.ZodString>;
+        /** The original user-provided idempotency key and scope */
+        idempotencyKeyOptions: z.ZodOptional<z.ZodObject<{
+            key: z.ZodString;
+            scope: z.ZodEnum<["run", "attempt", "global"]>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        }, {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        }>>;
         machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
         maxAttempts: z.ZodOptional<z.ZodNumber>;
         maxDuration: z.ZodOptional<z.ZodNumber>;
@@ -795,6 +818,19 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         priority: z.ZodOptional<z.ZodNumber>;
         bulkActionId: z.ZodOptional<z.ZodString>;
         region: z.ZodOptional<z.ZodString>;
+        debounce: z.ZodOptional<z.ZodObject<{
+            key: z.ZodString;
+            delay: z.ZodString;
+            mode: z.ZodOptional<z.ZodEnum<["leading", "trailing"]>>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        }, {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         metadata?: any;
         payloadType?: string | undefined;
@@ -813,6 +849,11 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         idempotencyKeyTTL?: string | undefined;
         concurrencyKey?: string | undefined;
         ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        } | undefined;
         dependentAttempt?: string | undefined;
         parentAttempt?: string | undefined;
         dependentBatch?: string | undefined;
@@ -820,6 +861,10 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         parentRunId?: string | undefined;
         resumeParentOnCompletion?: boolean | undefined;
         lockToVersion?: string | undefined;
+        idempotencyKeyOptions?: {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        } | undefined;
         metadataType?: string | undefined;
         test?: boolean | undefined;
         bulkActionId?: string | undefined;
@@ -841,6 +886,11 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         idempotencyKeyTTL?: string | undefined;
         concurrencyKey?: string | undefined;
         ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        } | undefined;
         dependentAttempt?: string | undefined;
         parentAttempt?: string | undefined;
         dependentBatch?: string | undefined;
@@ -848,6 +898,10 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         parentRunId?: string | undefined;
         resumeParentOnCompletion?: boolean | undefined;
         lockToVersion?: string | undefined;
+        idempotencyKeyOptions?: {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        } | undefined;
         metadataType?: string | undefined;
         test?: boolean | undefined;
         bulkActionId?: string | undefined;
@@ -871,6 +925,11 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         idempotencyKeyTTL?: string | undefined;
         concurrencyKey?: string | undefined;
         ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        } | undefined;
         dependentAttempt?: string | undefined;
         parentAttempt?: string | undefined;
         dependentBatch?: string | undefined;
@@ -878,6 +937,10 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         parentRunId?: string | undefined;
         resumeParentOnCompletion?: boolean | undefined;
         lockToVersion?: string | undefined;
+        idempotencyKeyOptions?: {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        } | undefined;
         metadataType?: string | undefined;
         test?: boolean | undefined;
         bulkActionId?: string | undefined;
@@ -903,6 +966,11 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         idempotencyKeyTTL?: string | undefined;
         concurrencyKey?: string | undefined;
         ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        } | undefined;
         dependentAttempt?: string | undefined;
         parentAttempt?: string | undefined;
         dependentBatch?: string | undefined;
@@ -910,6 +978,10 @@ export declare const TriggerTaskRequestBody: z.ZodObject<{
         parentRunId?: string | undefined;
         resumeParentOnCompletion?: boolean | undefined;
         lockToVersion?: string | undefined;
+        idempotencyKeyOptions?: {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        } | undefined;
         metadataType?: string | undefined;
         test?: boolean | undefined;
         bulkActionId?: string | undefined;
@@ -973,6 +1045,17 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             delay: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
             idempotencyKey: z.ZodOptional<z.ZodString>;
             idempotencyKeyTTL: z.ZodOptional<z.ZodString>;
+            /** The original user-provided idempotency key and scope */
+            idempotencyKeyOptions: z.ZodOptional<z.ZodObject<{
+                key: z.ZodString;
+                scope: z.ZodEnum<["run", "attempt", "global"]>;
+            }, "strip", z.ZodTypeAny, {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            }, {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            }>>;
             machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
             maxAttempts: z.ZodOptional<z.ZodNumber>;
             maxDuration: z.ZodOptional<z.ZodNumber>;
@@ -985,6 +1068,19 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             priority: z.ZodOptional<z.ZodNumber>;
             bulkActionId: z.ZodOptional<z.ZodString>;
             region: z.ZodOptional<z.ZodString>;
+            debounce: z.ZodOptional<z.ZodObject<{
+                key: z.ZodString;
+                delay: z.ZodString;
+                mode: z.ZodOptional<z.ZodEnum<["leading", "trailing"]>>;
+            }, "strip", z.ZodTypeAny, {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            }, {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             metadata?: any;
             payloadType?: string | undefined;
@@ -1003,6 +1099,11 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             dependentAttempt?: string | undefined;
             parentAttempt?: string | undefined;
             dependentBatch?: string | undefined;
@@ -1010,6 +1111,10 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             parentRunId?: string | undefined;
             resumeParentOnCompletion?: boolean | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
             bulkActionId?: string | undefined;
@@ -1031,6 +1136,11 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             dependentAttempt?: string | undefined;
             parentAttempt?: string | undefined;
             dependentBatch?: string | undefined;
@@ -1038,6 +1148,10 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             parentRunId?: string | undefined;
             resumeParentOnCompletion?: boolean | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
             bulkActionId?: string | undefined;
@@ -1061,6 +1175,11 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             dependentAttempt?: string | undefined;
             parentAttempt?: string | undefined;
             dependentBatch?: string | undefined;
@@ -1068,6 +1187,10 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             parentRunId?: string | undefined;
             resumeParentOnCompletion?: boolean | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
             bulkActionId?: string | undefined;
@@ -1093,6 +1216,11 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             dependentAttempt?: string | undefined;
             parentAttempt?: string | undefined;
             dependentBatch?: string | undefined;
@@ -1100,6 +1228,10 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             parentRunId?: string | undefined;
             resumeParentOnCompletion?: boolean | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
             bulkActionId?: string | undefined;
@@ -1128,6 +1260,11 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             dependentAttempt?: string | undefined;
             parentAttempt?: string | undefined;
             dependentBatch?: string | undefined;
@@ -1135,6 +1272,10 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             parentRunId?: string | undefined;
             resumeParentOnCompletion?: boolean | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
             bulkActionId?: string | undefined;
@@ -1163,6 +1304,11 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             dependentAttempt?: string | undefined;
             parentAttempt?: string | undefined;
             dependentBatch?: string | undefined;
@@ -1170,6 +1316,10 @@ export declare const BatchTriggerTaskRequestBody: z.ZodObject<{
             parentRunId?: string | undefined;
             resumeParentOnCompletion?: boolean | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
             bulkActionId?: string | undefined;
@@ -1189,6 +1339,17 @@ export declare const BatchTriggerTaskItem: z.ZodObject<{
         delay: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
         idempotencyKey: z.ZodOptional<z.ZodString>;
         idempotencyKeyTTL: z.ZodOptional<z.ZodString>;
+        /** The original user-provided idempotency key and scope */
+        idempotencyKeyOptions: z.ZodOptional<z.ZodObject<{
+            key: z.ZodString;
+            scope: z.ZodEnum<["run", "attempt", "global"]>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        }, {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        }>>;
         lockToVersion: z.ZodOptional<z.ZodString>;
         machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
         maxAttempts: z.ZodOptional<z.ZodNumber>;
@@ -1209,6 +1370,19 @@ export declare const BatchTriggerTaskItem: z.ZodObject<{
         ttl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         priority: z.ZodOptional<z.ZodNumber>;
         region: z.ZodOptional<z.ZodString>;
+        debounce: z.ZodOptional<z.ZodObject<{
+            key: z.ZodString;
+            delay: z.ZodString;
+            mode: z.ZodOptional<z.ZodEnum<["leading", "trailing"]>>;
+        }, "strip", z.ZodTypeAny, {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        }, {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         metadata?: any;
         payloadType?: string | undefined;
@@ -1226,8 +1400,17 @@ export declare const BatchTriggerTaskItem: z.ZodObject<{
         idempotencyKeyTTL?: string | undefined;
         concurrencyKey?: string | undefined;
         ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        } | undefined;
         parentAttempt?: string | undefined;
         lockToVersion?: string | undefined;
+        idempotencyKeyOptions?: {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        } | undefined;
         metadataType?: string | undefined;
         test?: boolean | undefined;
     }, {
@@ -1247,8 +1430,17 @@ export declare const BatchTriggerTaskItem: z.ZodObject<{
         idempotencyKeyTTL?: string | undefined;
         concurrencyKey?: string | undefined;
         ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        } | undefined;
         parentAttempt?: string | undefined;
         lockToVersion?: string | undefined;
+        idempotencyKeyOptions?: {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        } | undefined;
         metadataType?: string | undefined;
         test?: boolean | undefined;
     }>>;
@@ -1271,8 +1463,17 @@ export declare const BatchTriggerTaskItem: z.ZodObject<{
         idempotencyKeyTTL?: string | undefined;
         concurrencyKey?: string | undefined;
         ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        } | undefined;
         parentAttempt?: string | undefined;
         lockToVersion?: string | undefined;
+        idempotencyKeyOptions?: {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        } | undefined;
         metadataType?: string | undefined;
         test?: boolean | undefined;
     } | undefined;
@@ -1297,8 +1498,17 @@ export declare const BatchTriggerTaskItem: z.ZodObject<{
         idempotencyKeyTTL?: string | undefined;
         concurrencyKey?: string | undefined;
         ttl?: string | number | undefined;
+        debounce?: {
+            key: string;
+            delay: string;
+            mode?: "leading" | "trailing" | undefined;
+        } | undefined;
         parentAttempt?: string | undefined;
         lockToVersion?: string | undefined;
+        idempotencyKeyOptions?: {
+            key: string;
+            scope: "run" | "attempt" | "global";
+        } | undefined;
         metadataType?: string | undefined;
         test?: boolean | undefined;
     } | undefined;
@@ -1316,6 +1526,17 @@ export declare const BatchTriggerTaskV2RequestBody: z.ZodObject<{
             delay: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
             idempotencyKey: z.ZodOptional<z.ZodString>;
             idempotencyKeyTTL: z.ZodOptional<z.ZodString>;
+            /** The original user-provided idempotency key and scope */
+            idempotencyKeyOptions: z.ZodOptional<z.ZodObject<{
+                key: z.ZodString;
+                scope: z.ZodEnum<["run", "attempt", "global"]>;
+            }, "strip", z.ZodTypeAny, {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            }, {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            }>>;
             lockToVersion: z.ZodOptional<z.ZodString>;
             machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
             maxAttempts: z.ZodOptional<z.ZodNumber>;
@@ -1336,6 +1557,19 @@ export declare const BatchTriggerTaskV2RequestBody: z.ZodObject<{
             ttl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
             priority: z.ZodOptional<z.ZodNumber>;
             region: z.ZodOptional<z.ZodString>;
+            debounce: z.ZodOptional<z.ZodObject<{
+                key: z.ZodString;
+                delay: z.ZodString;
+                mode: z.ZodOptional<z.ZodEnum<["leading", "trailing"]>>;
+            }, "strip", z.ZodTypeAny, {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            }, {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             metadata?: any;
             payloadType?: string | undefined;
@@ -1353,8 +1587,17 @@ export declare const BatchTriggerTaskV2RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         }, {
@@ -1374,8 +1617,17 @@ export declare const BatchTriggerTaskV2RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         }>>;
@@ -1398,8 +1650,17 @@ export declare const BatchTriggerTaskV2RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         } | undefined;
@@ -1424,8 +1685,17 @@ export declare const BatchTriggerTaskV2RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         } | undefined;
@@ -1464,8 +1734,17 @@ export declare const BatchTriggerTaskV2RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         } | undefined;
@@ -1495,8 +1774,17 @@ export declare const BatchTriggerTaskV2RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         } | undefined;
@@ -1560,6 +1848,17 @@ export declare const BatchTriggerTaskV3RequestBody: z.ZodObject<{
             delay: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
             idempotencyKey: z.ZodOptional<z.ZodString>;
             idempotencyKeyTTL: z.ZodOptional<z.ZodString>;
+            /** The original user-provided idempotency key and scope */
+            idempotencyKeyOptions: z.ZodOptional<z.ZodObject<{
+                key: z.ZodString;
+                scope: z.ZodEnum<["run", "attempt", "global"]>;
+            }, "strip", z.ZodTypeAny, {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            }, {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            }>>;
             lockToVersion: z.ZodOptional<z.ZodString>;
             machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
             maxAttempts: z.ZodOptional<z.ZodNumber>;
@@ -1580,6 +1879,19 @@ export declare const BatchTriggerTaskV3RequestBody: z.ZodObject<{
             ttl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
             priority: z.ZodOptional<z.ZodNumber>;
             region: z.ZodOptional<z.ZodString>;
+            debounce: z.ZodOptional<z.ZodObject<{
+                key: z.ZodString;
+                delay: z.ZodString;
+                mode: z.ZodOptional<z.ZodEnum<["leading", "trailing"]>>;
+            }, "strip", z.ZodTypeAny, {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            }, {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             metadata?: any;
             payloadType?: string | undefined;
@@ -1597,8 +1909,17 @@ export declare const BatchTriggerTaskV3RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         }, {
@@ -1618,8 +1939,17 @@ export declare const BatchTriggerTaskV3RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         }>>;
@@ -1642,8 +1972,17 @@ export declare const BatchTriggerTaskV3RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         } | undefined;
@@ -1668,8 +2007,17 @@ export declare const BatchTriggerTaskV3RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         } | undefined;
@@ -1706,8 +2054,17 @@ export declare const BatchTriggerTaskV3RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         } | undefined;
@@ -1736,8 +2093,17 @@ export declare const BatchTriggerTaskV3RequestBody: z.ZodObject<{
             idempotencyKeyTTL?: string | undefined;
             concurrencyKey?: string | undefined;
             ttl?: string | number | undefined;
+            debounce?: {
+                key: string;
+                delay: string;
+                mode?: "leading" | "trailing" | undefined;
+            } | undefined;
             parentAttempt?: string | undefined;
             lockToVersion?: string | undefined;
+            idempotencyKeyOptions?: {
+                key: string;
+                scope: "run" | "attempt" | "global";
+            } | undefined;
             metadataType?: string | undefined;
             test?: boolean | undefined;
         } | undefined;
@@ -1772,16 +2138,35 @@ export declare const CreateBatchRequestBody: z.ZodObject<{
     resumeParentOnCompletion: z.ZodOptional<z.ZodBoolean>;
     /** Idempotency key for the batch */
     idempotencyKey: z.ZodOptional<z.ZodString>;
+    /** The original user-provided idempotency key and scope */
+    idempotencyKeyOptions: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        scope: z.ZodEnum<["run", "attempt", "global"]>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        scope: "run" | "attempt" | "global";
+    }, {
+        key: string;
+        scope: "run" | "attempt" | "global";
+    }>>;
 }, "strip", z.ZodTypeAny, {
     runCount: number;
     idempotencyKey?: string | undefined;
     parentRunId?: string | undefined;
     resumeParentOnCompletion?: boolean | undefined;
+    idempotencyKeyOptions?: {
+        key: string;
+        scope: "run" | "attempt" | "global";
+    } | undefined;
 }, {
     runCount: number;
     idempotencyKey?: string | undefined;
     parentRunId?: string | undefined;
     resumeParentOnCompletion?: boolean | undefined;
+    idempotencyKeyOptions?: {
+        key: string;
+        scope: "run" | "attempt" | "global";
+    } | undefined;
 }>;
 export type CreateBatchRequestBody = z.infer<typeof CreateBatchRequestBody>;
 /**
@@ -3320,6 +3705,20 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             values?: string[] | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        run: {
+            id: string;
+            isTest: boolean;
+            machine: {
+                cpu: number;
+                memory: number;
+                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
+                centsPerMs: number;
+            };
+            traceContext: Record<string, unknown>;
+            friendlyId: string;
+            attemptNumber: number;
+            masterQueue: string;
+        };
         version: "1";
         environment: {
             type: "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
@@ -3336,20 +3735,6 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             friendlyId?: string | undefined;
             imagePlatform?: string | undefined;
         };
-        run: {
-            id: string;
-            isTest: boolean;
-            machine: {
-                cpu: number;
-                memory: number;
-                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
-                centsPerMs: number;
-            };
-            traceContext: Record<string, unknown>;
-            friendlyId: string;
-            attemptNumber: number;
-            masterQueue: string;
-        };
         snapshot: {
             id: string;
             createdAt: Date;
@@ -3401,6 +3786,20 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             values?: string[] | undefined;
         }[] | undefined;
     }, {
+        run: {
+            id: string;
+            isTest: boolean;
+            machine: {
+                cpu: number;
+                memory: number;
+                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
+                centsPerMs: number;
+            };
+            traceContext: Record<string, unknown>;
+            friendlyId: string;
+            attemptNumber: number;
+            masterQueue: string;
+        };
         version: "1";
         environment: {
             type: "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
@@ -3417,20 +3816,6 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             friendlyId?: string | undefined;
             imagePlatform?: string | undefined;
         };
-        run: {
-            id: string;
-            isTest: boolean;
-            machine: {
-                cpu: number;
-                memory: number;
-                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
-                centsPerMs: number;
-            };
-            traceContext: Record<string, unknown>;
-            friendlyId: string;
-            attemptNumber: number;
-            masterQueue: string;
-        };
         snapshot: {
             id: string;
             createdAt: Date;
@@ -3484,6 +3869,20 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     dequeuedMessages: {
+        run: {
+            id: string;
+            isTest: boolean;
+            machine: {
+                cpu: number;
+                memory: number;
+                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
+                centsPerMs: number;
+            };
+            traceContext: Record<string, unknown>;
+            friendlyId: string;
+            attemptNumber: number;
+            masterQueue: string;
+        };
         version: "1";
         environment: {
             type: "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
@@ -3500,20 +3899,6 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             friendlyId?: string | undefined;
             imagePlatform?: string | undefined;
         };
-        run: {
-            id: string;
-            isTest: boolean;
-            machine: {
-                cpu: number;
-                memory: number;
-                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
-                centsPerMs: number;
-            };
-            traceContext: Record<string, unknown>;
-            friendlyId: string;
-            attemptNumber: number;
-            masterQueue: string;
-        };
         snapshot: {
             id: string;
             createdAt: Date;
@@ -3567,6 +3952,20 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
     }[];
 }, {
     dequeuedMessages: {
+        run: {
+            id: string;
+            isTest: boolean;
+            machine: {
+                cpu: number;
+                memory: number;
+                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
+                centsPerMs: number;
+            };
+            traceContext: Record<string, unknown>;
+            friendlyId: string;
+            attemptNumber: number;
+            masterQueue: string;
+        };
         version: "1";
         environment: {
             type: "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
@@ -3583,20 +3982,6 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             friendlyId?: string | undefined;
             imagePlatform?: string | undefined;
         };
-        run: {
-            id: string;
-            isTest: boolean;
-            machine: {
-                cpu: number;
-                memory: number;
-                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
-                centsPerMs: number;
-            };
-            traceContext: Record<string, unknown>;
-            friendlyId: string;
-            attemptNumber: number;
-            masterQueue: string;
-        };
         snapshot: {
             id: string;
             createdAt: Date;
@@ -3667,6 +4052,14 @@ export declare const CanceledRunResponse: z.ZodObject<{
     id: string;
 }>;
 export type CanceledRunResponse = z.infer<typeof CanceledRunResponse>;
+export declare const ResetIdempotencyKeyResponse: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export type ResetIdempotencyKeyResponse = z.infer<typeof ResetIdempotencyKeyResponse>;
 export declare const ScheduleType: z.ZodUnion<[z.ZodLiteral<"DECLARATIVE">, z.ZodLiteral<"IMPERATIVE">]>;
 export declare const ScheduledTaskPayload: z.ZodObject<{
     /** The schedule id associated with this run (you can have many schedules for the same task).