@trigger.dev/core 4.3.1 → 4.3.3

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

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const lruIdempotencyKeyCatalog_js_1 = require("./lruIdempotencyKeyCatalog.js");
+(0, vitest_1.describe)("LRUIdempotencyKeyCatalog", () => {
+    (0, vitest_1.describe)("registerKeyOptions and getKeyOptions", () => {
+        (0, vitest_1.it)("should store and retrieve options", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.LRUIdempotencyKeyCatalog();
+            const options = { key: "my-key", scope: "global" };
+            catalog.registerKeyOptions("hash1", options);
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toEqual(options);
+        });
+        (0, vitest_1.it)("should return undefined for non-existent keys", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.LRUIdempotencyKeyCatalog();
+            (0, vitest_1.expect)(catalog.getKeyOptions("non-existent")).toBeUndefined();
+        });
+        (0, vitest_1.it)("should store multiple keys", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.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);
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toEqual(options1);
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash2")).toEqual(options2);
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash3")).toEqual(options3);
+        });
+        (0, vitest_1.it)("should update options when registering same key twice", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.LRUIdempotencyKeyCatalog();
+            const options1 = { key: "key1", scope: "global" };
+            const options2 = { key: "key1-updated", scope: "run" };
+            catalog.registerKeyOptions("hash1", options1);
+            catalog.registerKeyOptions("hash1", options2);
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toEqual(options2);
+        });
+    });
+    (0, vitest_1.describe)("LRU eviction", () => {
+        (0, vitest_1.it)("should evict oldest entry when over capacity", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.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
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash2")).toBeDefined();
+            (0, vitest_1.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" });
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeUndefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash2")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash3")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        (0, vitest_1.it)("should evict least recently registered entry when capacity exceeded", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.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" });
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeUndefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash2")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash3")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        (0, vitest_1.it)("should evict multiple entries when adding many at once would exceed capacity", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.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
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeUndefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash2")).toBeUndefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash3")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        (0, vitest_1.it)("should work with maxSize of 1", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.LRUIdempotencyKeyCatalog(1);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeDefined();
+            catalog.registerKeyOptions("hash2", { key: "key2", scope: "global" });
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeUndefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash2")).toBeDefined();
+        });
+    });
+    (0, vitest_1.describe)("LRU ordering", () => {
+        (0, vitest_1.it)("should move accessed key to most recent position", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.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" });
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash2")).toBeUndefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash3")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        (0, vitest_1.it)("should move re-registered key to most recent position", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.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" });
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toEqual({ key: "key1-updated", scope: "run" });
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash2")).toBeUndefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash3")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash4")).toBeDefined();
+        });
+        (0, vitest_1.it)("should not affect order when getting non-existent key", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.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" });
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeUndefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash2")).toBeDefined();
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash3")).toBeDefined();
+        });
+    });
+    (0, vitest_1.describe)("default maxSize", () => {
+        (0, vitest_1.it)("should use default maxSize of 1000", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.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
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash0")).toBeUndefined();
+            // Last entry should exist
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1000")).toBeDefined();
+        });
+    });
+    (0, vitest_1.describe)("edge cases", () => {
+        (0, vitest_1.it)("should handle negative maxSize by clamping to 0", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.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
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeUndefined();
+        });
+        (0, vitest_1.it)("should handle maxSize of 0", () => {
+            const catalog = new lruIdempotencyKeyCatalog_js_1.LRUIdempotencyKeyCatalog(0);
+            catalog.registerKeyOptions("hash1", { key: "key1", scope: "global" });
+            // Should be immediately evicted since maxSize is 0
+            (0, vitest_1.expect)(catalog.getKeyOptions("hash1")).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=lruIdempotencyKeyCatalog.test.js.map

package/dist/commonjs/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/commonjs/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/commonjs/v3/idempotency-key-catalog-api.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.idempotencyKeyCatalog = void 0;
+// Split module-level variable definition into separate files to allow
+// tree-shaking on each api instance.
+const index_js_1 = require("./idempotency-key-catalog/index.js");
+/** Entrypoint for idempotency key catalog API */
+exports.idempotencyKeyCatalog = index_js_1.IdempotencyKeyCatalogAPI.getInstance();
+//# sourceMappingURL=idempotency-key-catalog-api.js.map

package/dist/commonjs/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,iEAA8E;AAC9E,iDAAiD;AACpC,QAAA,qBAAqB,GAAG,mCAAwB,CAAC,WAAW,EAAE,CAAC"}

package/dist/commonjs/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/commonjs/v3/idempotencyKeys.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getIdempotencyKeyOptions = getIdempotencyKeyOptions;
 exports.isIdempotencyKey = isIdempotencyKey;
 exports.flattenIdempotencyKey = flattenIdempotencyKey;
 exports.makeIdempotencyKey = makeIdempotencyKey;
@@ -7,11 +8,36 @@ exports.createIdempotencyKey = createIdempotencyKey;
 exports.attemptKey = attemptKey;
 exports.resetIdempotencyKey = resetIdempotencyKey;
 const apiClientManager_api_js_1 = require("./apiClientManager-api.js");
+const idempotency_key_catalog_api_js_1 = require("./idempotency-key-catalog-api.js");
 const task_context_api_js_1 = require("./task-context-api.js");
 const crypto_js_1 = require("./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" }
+ * ```
+ */
+function getIdempotencyKeyOptions(idempotencyKey) {
+    // Look up options from the catalog using the hash string
+    if (typeof idempotencyKey === "string") {
+        return idempotency_key_catalog_api_js_1.idempotencyKeyCatalog.getKeyOptions(idempotencyKey);
+    }
+    return undefined;
+}
 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;
 }
 function flattenIdempotencyKey(idempotencyKey) {
     if (!idempotencyKey) {
@@ -78,7 +104,13 @@ async function makeIdempotencyKey(idempotencyKey) {
  * ```
  */
 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
+    idempotency_key_catalog_api_js_1.idempotencyKeyCatalog.registerKeyOptions(idempotencyKey, { key: userKey, scope });
+    // Return primitive string cast as IdempotencyKey
     return idempotencyKey;
 }
 function injectScope(scope) {
@@ -105,9 +137,69 @@ async function generateIdempotencyKey(keyMaterial) {
 function attemptKey(ctx) {
     return `${ctx.run.id}-${ctx.attempt.number}`;
 }
-/** Resets an idempotency key, effectively deleting it from the associated task.*/
-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"
+ * });
+ * ```
+ */
+async function resetIdempotencyKey(taskIdentifier, idempotencyKey, options, requestOptions) {
     const client = apiClientManager_api_js_1.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 ?? task_context_api_js_1.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 ?? task_context_api_js_1.taskContext?.ctx?.run.id;
+            const attemptNumber = options?.attemptNumber ?? task_context_api_js_1.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/commonjs/v3/idempotencyKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.ts"],"names":[],"mappings":";;AA2BA,4DAQC;AAED,4CASC;AAED,sDAyBC;AAED,gDAcC;AAqCD,oDAeC;AAmCD,gCAEC;AAoCD,kDAsDC;AA5QD,uEAA6D;AAC7D,qFAAyE;AAKzE,+DAAoD;AAEpD,iDAAiD;AAMjD;;;;;;;;;;;;GAYG;AACH,SAAgB,wBAAwB,CACtC,cAAuC;IAEvC,yDAAyD;IACzD,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,sDAAqB,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAgB,gBAAgB,CAC9B,KAAyC;IAEzC,gGAAgG;IAChG,qEAAqE;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,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;AAEM,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;AACI,KAAK,UAAU,oBAAoB,CACxC,GAAsB,EACtB,OAAyC;IAEzC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEnC,MAAM,cAAc,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzF,0EAA0E;IAC1E,sDAAqB,CAAC,kBAAkB,CAAC,cAAc,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAElF,iDAAiD;IACjD,OAAO,cAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,WAAW,CAAC,KAA0B;IAC7C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,iCAAW,EAAE,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,iCAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,iCAAW,EAAE,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,iCAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,iCAAW,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,IAAA,wBAAY,EAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AAWD,6CAA6C;AAC7C,SAAgB,UAAU,CAAC,GAAuB;IAChD,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;AAC/C,CAAC;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,mBAAmB,CACvC,cAAsB,EACtB,cAAkD,EAClD,OAAoC,EACpC,cAAgC;IAEhC,MAAM,MAAM,GAAG,0CAAgB,CAAC,aAAa,EAAE,CAAC;IAEhD,wDAAwD;IACxD,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACvE,OAAO,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;IACpF,CAAC;IAED,sFAAsF;IACtF,MAAM,eAAe,GACnB,OAAO,cAAc,KAAK,QAAQ;QAChC,CAAC,CAAC,wBAAwB,CAAC,cAAc,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,KAAK,GAAG,eAAe,EAAE,KAAK,IAAI,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC;IAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;QAC5C,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,CAAC,eAAe,EAAE,GAAG,IAAI,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;IAErD,yCAAyC;IACzC,IAAI,WAAW,GAAa,EAAE,CAAC;IAC/B,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,iCAAW,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,iGAAiG,CAClG,CAAC;YACJ,CAAC;YACD,WAAW,GAAG,CAAC,WAAW,CAAC,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,iCAAW,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACrE,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,iCAAW,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC;YACjF,IAAI,CAAC,WAAW,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChD,MAAM,IAAI,KAAK,CACb,wHAAwH,CACzH,CAAC;YACJ,CAAC;YACD,WAAW,GAAG,CAAC,WAAW,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtD,MAAM;QACR,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAExE,OAAO,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;AAC1E,CAAC"}

package/dist/commonjs/v3/imports/superjson-cjs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"superjson-cjs.cjs","sourceRoot":"","sources":["../../../../src/v3/imports/superjson-cjs.cts"],"names":[],"mappings":";;AAAA,aAAa;AACb,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAEpD,aAAa;AACb,SAAS,CAAC,cAAc,CACtB;IACE,YAAY,EAAE,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7F,SAAS,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAChC,WAAW,EAAE,CAAC,CAAW,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;CAC7C,EACD,QAAQ,CACT,CAAC;AAEF,aAAa;AACb,MAAM,CAAC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC"}

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

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

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-ignore
+const { default: superjson } = require("superjson");
+// @ts-ignore
+superjson.registerCustom({
+    isApplicable: (v) => typeof Buffer === "function" && Buffer.isBuffer(v),
+    serialize: (v) => [...v],
+    deserialize: (v) => Buffer.from(v),
+}, "buffer");
+// @ts-ignore
+module.exports.default = superjson;
+//# sourceMappingURL=superjson-cjs.cjs.map

package/dist/commonjs/v3/runEngineWorker/supervisor/http.d.ts

@@ -17,6 +17,20 @@ export declare class SupervisorHttpClient {
         };
     }>>;
     dequeue(body: WorkerApiDequeueRequestBody): Promise<import("../../zodfetch.js").ApiResult<{
+        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";
@@ -33,20 +47,6 @@ export declare class SupervisorHttpClient {
             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;
@@ -100,6 +100,20 @@ export declare class SupervisorHttpClient {
     }[]>>;
     /** @deprecated Not currently used */
     dequeueFromVersion(deploymentId: string, maxRunCount?: number, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
+        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";
@@ -116,20 +130,6 @@ export declare class SupervisorHttpClient {
             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;
@@ -204,6 +204,37 @@ export declare class SupervisorHttpClient {
         };
     } & {
         execution: {
+            run: {
+                payload: string;
+                id: string;
+                payloadType: string;
+                tags: string[];
+                isTest: boolean;
+                createdAt: Date;
+                startedAt: Date;
+                metadata?: Record<string, import("../../../index.js").DeserializedJson> | undefined;
+                idempotencyKey?: string | undefined;
+                idempotencyKeyScope?: "run" | "attempt" | "global" | undefined;
+                maxAttempts?: number | undefined;
+                version?: string | undefined;
+                maxDuration?: number | undefined;
+                priority?: number | undefined;
+                baseCostInCents?: number | undefined;
+                parentTaskRunId?: string | undefined;
+                rootTaskRunId?: string | undefined;
+                durationMs?: number | undefined;
+                costInCents?: number | undefined;
+                region?: string | undefined;
+            } & {
+                traceContext?: Record<string, unknown> | undefined;
+                realtimeStreamsVersion?: string | undefined;
+            };
+            attempt: {
+                number: number;
+                startedAt: Date;
+            } & {
+                [k: string]: unknown;
+            };
             task: {
                 id: string;
                 filePath: string;
@@ -252,36 +283,6 @@ export declare class SupervisorHttpClient {
                 name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
                 centsPerMs: number;
             };
-            attempt: {
-                number: number;
-                startedAt: Date;
-            } & {
-                [k: string]: unknown;
-            };
-            run: {
-                payload: string;
-                id: string;
-                payloadType: string;
-                tags: string[];
-                isTest: boolean;
-                createdAt: Date;
-                startedAt: Date;
-                metadata?: Record<string, import("../../../index.js").DeserializedJson> | undefined;
-                idempotencyKey?: string | undefined;
-                maxAttempts?: number | undefined;
-                version?: string | undefined;
-                maxDuration?: number | undefined;
-                priority?: number | undefined;
-                baseCostInCents?: number | undefined;
-                parentTaskRunId?: string | undefined;
-                rootTaskRunId?: string | undefined;
-                durationMs?: number | undefined;
-                costInCents?: number | undefined;
-                region?: string | undefined;
-            } & {
-                traceContext?: Record<string, unknown> | undefined;
-                realtimeStreamsVersion?: string | undefined;
-            };
             batch?: {
                 id: string;
             } | undefined;
@@ -333,7 +334,6 @@ export declare class SupervisorHttpClient {
     }>>;
     getLatestSnapshot(runId: string, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
         execution: {
-            version: "1";
             run: {
                 status: import("../../index.js").TaskRunStatus;
                 id: string;
@@ -341,6 +341,7 @@ export declare class SupervisorHttpClient {
                 attemptNumber?: number | null | undefined;
                 taskEventStore?: string | undefined;
             };
+            version: "1";
             snapshot: {
                 id: string;
                 createdAt: Date;
@@ -388,7 +389,6 @@ export declare class SupervisorHttpClient {
     }>>;
     getSnapshotsSince(runId: string, snapshotId: string, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
         snapshots: {
-            version: "1";
             run: {
                 status: import("../../index.js").TaskRunStatus;
                 id: string;
@@ -396,6 +396,7 @@ export declare class SupervisorHttpClient {
                 attemptNumber?: number | null | undefined;
                 taskEventStore?: string | undefined;
             };
+            version: "1";
             snapshot: {
                 id: string;
                 createdAt: Date;