@trigger.dev/core 4.3.1 → 4.3.3

package/dist/esm/v3/idempotency-key-catalog/index.js

@@ -0,0 +1,29 @@
+const API_NAME = "idempotency-key-catalog";
+import { getGlobal, registerGlobal } from "../utils/globals.js";
+import { LRUIdempotencyKeyCatalog } from "./lruIdempotencyKeyCatalog.js";
+export class IdempotencyKeyCatalogAPI {
+    static _instance;
+    constructor() { }
+    static getInstance() {
+        if (!this._instance) {
+            this._instance = new IdempotencyKeyCatalogAPI();
+        }
+        return this._instance;
+    }
+    registerKeyOptions(hash, options) {
+        this.#getCatalog().registerKeyOptions(hash, options);
+    }
+    getKeyOptions(hash) {
+        return this.#getCatalog().getKeyOptions(hash);
+    }
+    #getCatalog() {
+        let catalog = getGlobal(API_NAME);
+        if (!catalog) {
+            // Auto-initialize with LRU catalog on first access
+            catalog = new LRUIdempotencyKeyCatalog();
+            registerGlobal(API_NAME, catalog, true);
+        }
+        return catalog;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/v3/idempotency-key-catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/idempotency-key-catalog/index.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,yBAAyB,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,MAAM,OAAO,wBAAwB;IAC3B,MAAM,CAAC,SAAS,CAA4B;IAEpD,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAwB,EAAE,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,kBAAkB,CAAC,IAAY,EAAE,OAA8B;QACpE,IAAI,CAAC,WAAW,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAEM,aAAa,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,WAAW;QACT,IAAI,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,mDAAmD;YACnD,OAAO,GAAG,IAAI,wBAAwB,EAAE,CAAC;YACzC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/esm/v3/idempotency-key-catalog/lruIdempotencyKeyCatalog.d.ts

@@ -0,0 +1,8 @@
+import type { IdempotencyKeyCatalog, IdempotencyKeyOptions } from "./catalog.js";
+export declare class LRUIdempotencyKeyCatalog implements IdempotencyKeyCatalog {
+    private cache;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    registerKeyOptions(hash: string, options: IdempotencyKeyOptions): void;
+    getKeyOptions(hash: string): IdempotencyKeyOptions | undefined;
+}

package/dist/esm/v3/idempotency-key-catalog/lruIdempotencyKeyCatalog.js

@@ -0,0 +1,31 @@
+export class LRUIdempotencyKeyCatalog {
+    cache;
+    maxSize;
+    constructor(maxSize = 1_000) {
+        this.cache = new Map();
+        // Clamp to non-negative to prevent infinite loop in eviction
+        this.maxSize = Math.max(0, maxSize);
+    }
+    registerKeyOptions(hash, options) {
+        // Delete and re-add to update position (most recently used)
+        this.cache.delete(hash);
+        this.cache.set(hash, options);
+        // Evict oldest entries if over capacity
+        while (this.cache.size > this.maxSize) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest !== undefined) {
+                this.cache.delete(oldest);
+            }
+        }
+    }
+    getKeyOptions(hash) {
+        const options = this.cache.get(hash);
+        if (options) {
+            // Move to end (most recently used)
+            this.cache.delete(hash);
+            this.cache.set(hash, options);
+        }
+        return options;
+    }
+}
+//# sourceMappingURL=lruIdempotencyKeyCatalog.js.map

package/dist/esm/v3/idempotency-key-catalog/lruIdempotencyKeyCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lruIdempotencyKeyCatalog.js","sourceRoot":"","sources":["../../../../src/v3/idempotency-key-catalog/lruIdempotencyKeyCatalog.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,wBAAwB;IAC3B,KAAK,CAAqC;IACjC,OAAO,CAAS;IAEjC,YAAY,UAAkB,KAAK;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,6DAA6D;QAC7D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,kBAAkB,CAAC,IAAY,EAAE,OAA8B;QAC7D,4DAA4D;QAC5D,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE9B,wCAAwC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,OAAO,EAAE,CAAC;YACZ,mCAAmC;YACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/esm/v3/idempotency-key-catalog/lruIdempotencyKeyCatalog.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/v3/idempotency-key-catalog/lruIdempotencyKeyCatalog.test.js

@@ -0,0 +1,159 @@
+import { describe, it, expect } from "vitest";
+import { LRUIdempotencyKeyCatalog } from "./lruIdempotencyKeyCatalog.js";
+describe("LRUIdempotencyKeyCatalog", () => {
+    describe("registerKeyOptions and getKeyOptions", () => {
+        it("should store and retrieve options", () => {
+            const catalog = new LRUIdempotencyKeyCatalog();
+            const options = { key: "my-key", scope: "global" };
+            catalog.registerKeyOptions("hash1", options);
+            expect(catalog.getKeyOptions("hash1")).toEqual(options);
+        });
+        it("should return undefined for non-existent keys", () => {
+            const catalog = new LRUIdempotencyKeyCatalog();
+            expect(catalog.getKeyOptions("non-existent")).toBeUndefined();
+        });
+        it("should store multiple keys", () => {
+            const catalog = new LRUIdempotencyKeyCatalog();
+            const options1 = { key: "key1", scope: "global" };
+            const options2 = { key: "key2", scope: "run" };
+            const options3 = { key: "key3", scope: "attempt" };
+            catalog.registerKeyOptions("hash1", options1);
+            catalog.registerKeyOptions("hash2", options2);
+            catalog.registerKeyOptions("hash3", options3);
+            expect(catalog.getKeyOptions("hash1")).toEqual(options1);
+            expect(catalog.getKeyOptions("hash2")).toEqual(options2);
+            expect(catalog.getKeyOptions("hash3")).toEqual(options3);
+        });
+        it("should update options when registering same key twice", () => {
+            const catalog = new LRUIdempotencyKeyCatalog();
+            const options1 = { key: "key1", scope: "global" };
+            const options2 = { key: "key1-updated", scope: "run" };
+            catalog.registerKeyOptions("hash1", options1);
+            catalog.registerKeyOptions("hash1", options2);
+            expect(catalog.getKeyOptions("hash1")).toEqual(options2);
+        });
+    });
+    describe("LRU eviction", () => {
+        it("should evict oldest entry when over capacity", () => {
+            const catalog = new LRUIdempotencyKeyCatalog(3);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            catalog.registerKeyOptions("hash2", { key: "key2", scope: "global" });
+            catalog.registerKeyOptions("hash3", { key: "key3", scope: "global" });
+            // All three should exist
+            expect(catalog.getKeyOptions("hash1")).toBeDefined();
+            expect(catalog.getKeyOptions("hash2")).toBeDefined();
+            expect(catalog.getKeyOptions("hash3")).toBeDefined();
+            // After the gets above, the LRU order from oldest to newest is: hash1, hash2, hash3
+            // (each get moves the key to the most recent position)
+            // Add a fourth - hash1 should be evicted (it was accessed first, so it's the oldest)
+            catalog.registerKeyOptions("hash4", { key: "key4", scope: "global" });
+            expect(catalog.getKeyOptions("hash1")).toBeUndefined();
+            expect(catalog.getKeyOptions("hash2")).toBeDefined();
+            expect(catalog.getKeyOptions("hash3")).toBeDefined();
+            expect(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        it("should evict least recently registered entry when capacity exceeded", () => {
+            const catalog = new LRUIdempotencyKeyCatalog(3);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            catalog.registerKeyOptions("hash2", { key: "key2", scope: "global" });
+            catalog.registerKeyOptions("hash3", { key: "key3", scope: "global" });
+            // Adding fourth should evict hash1 (oldest)
+            catalog.registerKeyOptions("hash4", { key: "key4", scope: "global" });
+            expect(catalog.getKeyOptions("hash1")).toBeUndefined();
+            expect(catalog.getKeyOptions("hash2")).toBeDefined();
+            expect(catalog.getKeyOptions("hash3")).toBeDefined();
+            expect(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        it("should evict multiple entries when adding many at once would exceed capacity", () => {
+            const catalog = new LRUIdempotencyKeyCatalog(2);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            catalog.registerKeyOptions("hash2", { key: "key2", scope: "global" });
+            catalog.registerKeyOptions("hash3", { key: "key3", scope: "global" });
+            catalog.registerKeyOptions("hash4", { key: "key4", scope: "global" });
+            // Only hash3 and hash4 should remain
+            expect(catalog.getKeyOptions("hash1")).toBeUndefined();
+            expect(catalog.getKeyOptions("hash2")).toBeUndefined();
+            expect(catalog.getKeyOptions("hash3")).toBeDefined();
+            expect(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        it("should work with maxSize of 1", () => {
+            const catalog = new LRUIdempotencyKeyCatalog(1);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            expect(catalog.getKeyOptions("hash1")).toBeDefined();
+            catalog.registerKeyOptions("hash2", { key: "key2", scope: "global" });
+            expect(catalog.getKeyOptions("hash1")).toBeUndefined();
+            expect(catalog.getKeyOptions("hash2")).toBeDefined();
+        });
+    });
+    describe("LRU ordering", () => {
+        it("should move accessed key to most recent position", () => {
+            const catalog = new LRUIdempotencyKeyCatalog(3);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            catalog.registerKeyOptions("hash2", { key: "key2", scope: "global" });
+            catalog.registerKeyOptions("hash3", { key: "key3", scope: "global" });
+            // Access hash1, moving it to most recent
+            catalog.getKeyOptions("hash1");
+            // Add hash4 - should evict hash2 (now the oldest)
+            catalog.registerKeyOptions("hash4", { key: "key4", scope: "global" });
+            expect(catalog.getKeyOptions("hash1")).toBeDefined();
+            expect(catalog.getKeyOptions("hash2")).toBeUndefined();
+            expect(catalog.getKeyOptions("hash3")).toBeDefined();
+            expect(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        it("should move re-registered key to most recent position", () => {
+            const catalog = new LRUIdempotencyKeyCatalog(3);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            catalog.registerKeyOptions("hash2", { key: "key2", scope: "global" });
+            catalog.registerKeyOptions("hash3", { key: "key3", scope: "global" });
+            // Re-register hash1, moving it to most recent
+            catalog.registerKeyOptions("hash1", { key: "key1-updated", scope: "run" });
+            // Add hash4 - should evict hash2 (now the oldest)
+            catalog.registerKeyOptions("hash4", { key: "key4", scope: "global" });
+            expect(catalog.getKeyOptions("hash1")).toEqual({ key: "key1-updated", scope: "run" });
+            expect(catalog.getKeyOptions("hash2")).toBeUndefined();
+            expect(catalog.getKeyOptions("hash3")).toBeDefined();
+            expect(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        it("should not affect order when getting non-existent key", () => {
+            const catalog = new LRUIdempotencyKeyCatalog(2);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            catalog.registerKeyOptions("hash2", { key: "key2", scope: "global" });
+            // Try to get non-existent key
+            catalog.getKeyOptions("non-existent");
+            // Add hash3 - should still evict hash1 (oldest)
+            catalog.registerKeyOptions("hash3", { key: "key3", scope: "global" });
+            expect(catalog.getKeyOptions("hash1")).toBeUndefined();
+            expect(catalog.getKeyOptions("hash2")).toBeDefined();
+            expect(catalog.getKeyOptions("hash3")).toBeDefined();
+        });
+    });
+    describe("default maxSize", () => {
+        it("should use default maxSize of 1000", () => {
+            const catalog = new LRUIdempotencyKeyCatalog();
+            // Register 1001 entries
+            for (let i = 0; i < 1001; i++) {
+                catalog.registerKeyOptions(`hash${i}`, { key: `key${i}`, scope: "global" });
+            }
+            // First entry should be evicted
+            expect(catalog.getKeyOptions("hash0")).toBeUndefined();
+            // Last entry should exist
+            expect(catalog.getKeyOptions("hash1000")).toBeDefined();
+        });
+    });
+    describe("edge cases", () => {
+        it("should handle negative maxSize by clamping to 0", () => {
+            const catalog = new LRUIdempotencyKeyCatalog(-5);
+            // With maxSize clamped to 0, nothing should be stored
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            // Should be immediately evicted since maxSize is 0
+            expect(catalog.getKeyOptions("hash1")).toBeUndefined();
+        });
+        it("should handle maxSize of 0", () => {
+            const catalog = new LRUIdempotencyKeyCatalog(0);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            // Should be immediately evicted since maxSize is 0
+            expect(catalog.getKeyOptions("hash1")).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=lruIdempotencyKeyCatalog.test.js.map

package/dist/esm/v3/idempotency-key-catalog/lruIdempotencyKeyCatalog.test.js.map

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

package/dist/esm/v3/idempotency-key-catalog-api.d.ts

@@ -0,0 +1,3 @@
+import { IdempotencyKeyCatalogAPI } from "./idempotency-key-catalog/index.js";
+/** Entrypoint for idempotency key catalog API */
+export declare const idempotencyKeyCatalog: IdempotencyKeyCatalogAPI;

package/dist/esm/v3/idempotency-key-catalog-api.js

@@ -0,0 +1,6 @@
+// Split module-level variable definition into separate files to allow
+// tree-shaking on each api instance.
+import { IdempotencyKeyCatalogAPI } from "./idempotency-key-catalog/index.js";
+/** Entrypoint for idempotency key catalog API */
+export const idempotencyKeyCatalog = IdempotencyKeyCatalogAPI.getInstance();
+//# sourceMappingURL=idempotency-key-catalog-api.js.map

package/dist/esm/v3/idempotency-key-catalog-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency-key-catalog-api.js","sourceRoot":"","sources":["../../../src/v3/idempotency-key-catalog-api.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,qCAAqC;AACrC,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,iDAAiD;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,WAAW,EAAE,CAAC"}

package/dist/esm/v3/idempotencyKeys.d.ts

@@ -1,5 +1,21 @@
+import type { IdempotencyKeyOptions, IdempotencyKeyScope } from "./idempotency-key-catalog/catalog.js";
 import { IdempotencyKey } from "./types/idempotencyKeys.js";
 import type { ZodFetchOptions } from "./apiClient/core.js";
+export type { IdempotencyKeyScope, IdempotencyKeyOptions } from "./idempotency-key-catalog/catalog.js";
+/**
+ * Extracts the user-provided key and scope from an idempotency key created with `idempotencyKeys.create()`.
+ *
+ * @param idempotencyKey The idempotency key to extract options from
+ * @returns The original key and scope, or undefined if the key doesn't have attached options
+ *
+ * @example
+ * ```typescript
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * const options = getIdempotencyKeyOptions(key);
+ * // options = { key: "my-key", scope: "global" }
+ * ```
+ */
+export declare function getIdempotencyKeyOptions(idempotencyKey: IdempotencyKey | string): IdempotencyKeyOptions | undefined;
 export declare function isIdempotencyKey(value: string | string[] | IdempotencyKey): value is IdempotencyKey;
 export declare function flattenIdempotencyKey(idempotencyKey?: IdempotencyKey | string | string[] | (undefined | IdempotencyKey | string | string[])[]): IdempotencyKey | string | string[] | undefined;
 export declare function makeIdempotencyKey(idempotencyKey?: IdempotencyKey | string | string[]): Promise<IdempotencyKey | undefined>;
@@ -39,7 +55,7 @@ export declare function makeIdempotencyKey(idempotencyKey?: IdempotencyKey | str
  * ```
  */
 export declare function createIdempotencyKey(key: string | string[], options?: {
-    scope?: "run" | "attempt" | "global";
+    scope?: IdempotencyKeyScope;
 }): Promise<IdempotencyKey>;
 type AttemptKeyMaterial = {
     run: {
@@ -51,8 +67,39 @@ type AttemptKeyMaterial = {
 };
 /** Creates a unique key for each attempt. */
 export declare function attemptKey(ctx: AttemptKeyMaterial): string;
-/** Resets an idempotency key, effectively deleting it from the associated task.*/
-export declare function resetIdempotencyKey(taskIdentifier: string, idempotencyKey: string, requestOptions?: ZodFetchOptions): Promise<{
+export type ResetIdempotencyKeyOptions = {
+    scope?: IdempotencyKeyScope;
+    /** Required if scope is "run" or "attempt" to reconstruct the hash */
+    parentRunId?: string;
+    /** Required if scope is "attempt" to reconstruct the hash */
+    attemptNumber?: number;
+};
+/**
+ * Resets an idempotency key, effectively deleting it from the associated task.
+ *
+ * @param taskIdentifier The task identifier (e.g., "my-task")
+ * @param idempotencyKey The idempotency key to reset. Can be:
+ *   - An `IdempotencyKey` created with `idempotencyKeys.create()` (options are extracted automatically)
+ *   - A string or string array (requires `options.scope` and potentially `options.parentRunId`)
+ * @param options Options for reconstructing the hash if needed
+ * @param requestOptions Optional fetch options
+ *
+ * @example
+ * ```typescript
+ * // Using a key created with idempotencyKeys.create() - options are extracted automatically
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * await idempotencyKeys.reset("my-task", key);
+ *
+ * // Using a raw string with global scope
+ * await idempotencyKeys.reset("my-task", "my-key", { scope: "global" });
+ *
+ * // Using a raw string with run scope (requires parentRunId)
+ * await idempotencyKeys.reset("my-task", "my-key", {
+ *   scope: "run",
+ *   parentRunId: "run_abc123"
+ * });
+ * ```
+ */
+export declare function resetIdempotencyKey(taskIdentifier: string, idempotencyKey: IdempotencyKey | string | string[], options?: ResetIdempotencyKeyOptions, requestOptions?: ZodFetchOptions): Promise<{
     id: string;
 }>;
-export {};

package/dist/esm/v3/idempotencyKeys.js

@@ -1,9 +1,34 @@
 import { apiClientManager } from "./apiClientManager-api.js";
+import { idempotencyKeyCatalog } from "./idempotency-key-catalog-api.js";
 import { taskContext } from "./task-context-api.js";
 import { digestSHA256 } from "./utils/crypto.js";
+/**
+ * Extracts the user-provided key and scope from an idempotency key created with `idempotencyKeys.create()`.
+ *
+ * @param idempotencyKey The idempotency key to extract options from
+ * @returns The original key and scope, or undefined if the key doesn't have attached options
+ *
+ * @example
+ * ```typescript
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * const options = getIdempotencyKeyOptions(key);
+ * // options = { key: "my-key", scope: "global" }
+ * ```
+ */
+export function getIdempotencyKeyOptions(idempotencyKey) {
+    // Look up options from the catalog using the hash string
+    if (typeof idempotencyKey === "string") {
+        return idempotencyKeyCatalog.getKeyOptions(idempotencyKey);
+    }
+    return undefined;
+}
 export function isIdempotencyKey(value) {
     // Cannot check the brand at runtime because it doesn't exist (it's a TypeScript-only construct)
-    return typeof value === "string" && value.length === 64;
+    // Check for primitive strings only (we no longer use String objects)
+    if (typeof value === "string") {
+        return value.length === 64;
+    }
+    return false;
 }
 export function flattenIdempotencyKey(idempotencyKey) {
     if (!idempotencyKey) {
@@ -70,7 +95,13 @@ export async function makeIdempotencyKey(idempotencyKey) {
  * ```
  */
 export async function createIdempotencyKey(key, options) {
-    const idempotencyKey = await generateIdempotencyKey([...(Array.isArray(key) ? key : [key])].concat(injectScope(options?.scope ?? "run")));
+    const scope = options?.scope ?? "run";
+    const keyArray = Array.isArray(key) ? key : [key];
+    const userKey = keyArray.join("-");
+    const idempotencyKey = await generateIdempotencyKey(keyArray.concat(injectScope(scope)));
+    // Register the original key and scope in the catalog for later extraction
+    idempotencyKeyCatalog.registerKeyOptions(idempotencyKey, { key: userKey, scope });
+    // Return primitive string cast as IdempotencyKey
     return idempotencyKey;
 }
 function injectScope(scope) {
@@ -97,9 +128,69 @@ async function generateIdempotencyKey(keyMaterial) {
 export function attemptKey(ctx) {
     return `${ctx.run.id}-${ctx.attempt.number}`;
 }
-/** Resets an idempotency key, effectively deleting it from the associated task.*/
-export async function resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions) {
+/**
+ * Resets an idempotency key, effectively deleting it from the associated task.
+ *
+ * @param taskIdentifier The task identifier (e.g., "my-task")
+ * @param idempotencyKey The idempotency key to reset. Can be:
+ *   - An `IdempotencyKey` created with `idempotencyKeys.create()` (options are extracted automatically)
+ *   - A string or string array (requires `options.scope` and potentially `options.parentRunId`)
+ * @param options Options for reconstructing the hash if needed
+ * @param requestOptions Optional fetch options
+ *
+ * @example
+ * ```typescript
+ * // Using a key created with idempotencyKeys.create() - options are extracted automatically
+ * const key = await idempotencyKeys.create("my-key", { scope: "global" });
+ * await idempotencyKeys.reset("my-task", key);
+ *
+ * // Using a raw string with global scope
+ * await idempotencyKeys.reset("my-task", "my-key", { scope: "global" });
+ *
+ * // Using a raw string with run scope (requires parentRunId)
+ * await idempotencyKeys.reset("my-task", "my-key", {
+ *   scope: "run",
+ *   parentRunId: "run_abc123"
+ * });
+ * ```
+ */
+export async function resetIdempotencyKey(taskIdentifier, idempotencyKey, options, requestOptions) {
     const client = apiClientManager.clientOrThrow();
-    return client.resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions);
+    // If the key is already a 64-char hash, use it directly
+    if (typeof idempotencyKey === "string" && idempotencyKey.length === 64) {
+        return client.resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions);
+    }
+    // Try to extract options from an IdempotencyKey created with idempotencyKeys.create()
+    const attachedOptions = typeof idempotencyKey === "string"
+        ? getIdempotencyKeyOptions(idempotencyKey)
+        : undefined;
+    const scope = attachedOptions?.scope ?? options?.scope ?? "run";
+    const keyArray = Array.isArray(idempotencyKey)
+        ? idempotencyKey
+        : [attachedOptions?.key ?? String(idempotencyKey)];
+    // Build scope suffix based on scope type
+    let scopeSuffix = [];
+    switch (scope) {
+        case "run": {
+            const parentRunId = options?.parentRunId ?? taskContext?.ctx?.run.id;
+            if (!parentRunId) {
+                throw new Error("resetIdempotencyKey: parentRunId is required for 'run' scope when called outside a task context");
+            }
+            scopeSuffix = [parentRunId];
+            break;
+        }
+        case "attempt": {
+            const parentRunId = options?.parentRunId ?? taskContext?.ctx?.run.id;
+            const attemptNumber = options?.attemptNumber ?? taskContext?.ctx?.attempt.number;
+            if (!parentRunId || attemptNumber === undefined) {
+                throw new Error("resetIdempotencyKey: parentRunId and attemptNumber are required for 'attempt' scope when called outside a task context");
+            }
+            scopeSuffix = [parentRunId, attemptNumber.toString()];
+            break;
+        }
+    }
+    // Generate the hash using the same algorithm as createIdempotencyKey
+    const hash = await generateIdempotencyKey(keyArray.concat(scopeSuffix));
+    return client.resetIdempotencyKey(taskIdentifier, hash, requestOptions);
 }
 //# sourceMappingURL=idempotencyKeys.js.map

package/dist/esm/v3/idempotencyKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,UAAU,gBAAgB,CAC9B,KAAyC;IAEzC,gGAAgG;IAChG,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,cAIsD;IAEtD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QAClC,sEAAsE;QACtE,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;YAChD,OAAO;QACT,CAAC;QAED,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACpC,MAAM,CAAC,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,CAAC;gBAAE,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAa,CAAC;IACjB,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,cAAmD;IAEnD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC;QACrC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,oBAAoB,CAAC,cAAc,EAAE;QAChD,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAsB,EACtB,OAAkD;IAElD,MAAM,cAAc,GAAG,MAAM,sBAAsB,CACjD,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC,CACrF,CAAC;IAEF,OAAO,cAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,WAAW,CAAC,KAAmC;IACtD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,WAAW,EAAE,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,WAAW,EAAE,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,WAAqB;IACzD,OAAO,MAAM,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AAWD,6CAA6C;AAC7C,MAAM,UAAU,UAAU,CAAC,GAAuB;IAChD,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,cAAsB,EACtB,cAAsB,EACtB,cAAgC;IAEhC,MAAM,MAAM,GAAG,gBAAgB,CAAC,aAAa,EAAE,CAAC;IAEhD,OAAO,MAAM,CAAC,mBAAmB,CAC/B,cAAc,EACd,cAAc,EACd,cAAc,CACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/imports/superjson.d.ts

@@ -0,0 +1,2 @@
+import superjson from "superjson";
+export default superjson;

package/dist/esm/v3/imports/superjson.js

@@ -0,0 +1,10 @@
+// @ts-ignore
+import superjson from "superjson";
+superjson.registerCustom({
+    isApplicable: (v) => typeof Buffer === "function" && Buffer.isBuffer(v),
+    serialize: (v) => [...v],
+    deserialize: (v) => Buffer.from(v),
+}, "buffer");
+// @ts-ignore
+export default superjson;
+//# sourceMappingURL=superjson.js.map

package/dist/esm/v3/imports/superjson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"superjson.js","sourceRoot":"","sources":["../../../../src/v3/imports/superjson.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC,SAAS,CAAC,cAAc,CACtB;IACE,YAAY,EAAE,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpF,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;CACnC,EACD,QAAQ,CACT,CAAC;AAEF,aAAa;AACb,eAAe,SAAS,CAAC"}