@trigger.dev/core 3.3.17 → 4.0.0-v4-beta.0

package/dist/commonjs/v3/types/queues.d.ts

@@ -0,0 +1,43 @@
+export type QueueOptions = {
+    /** You can define a shared queue and then pass the name in to your task.
+     *
+     * @example
+     *
+     * ```ts
+     * const myQueue = queue({
+        name: "my-queue",
+        concurrencyLimit: 1,
+      });
+  
+      export const task1 = task({
+        id: "task-1",
+        queue: {
+          name: "my-queue",
+        },
+        run: async (payload: { message: string }) => {
+          // ...
+        },
+      });
+  
+      export const task2 = task({
+        id: "task-2",
+        queue: {
+          name: "my-queue",
+        },
+        run: async (payload: { message: string }) => {
+          // ...
+        },
+      });
+     * ```
+     */
+    name: string;
+    /** An optional property that specifies the maximum number of concurrent run executions.
+     *
+     * If this property is omitted, the task can potentially use up the full concurrency of an environment */
+    concurrencyLimit?: number;
+    /** An optional property that specifies whether to release concurrency on waitpoint.
+     *
+     * If this property is omitted, the task will not release concurrency on waitpoint.
+     */
+    releaseConcurrencyOnWaitpoint?: boolean;
+};

package/dist/commonjs/v3/types/queues.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=queues.js.map

package/dist/commonjs/v3/types/queues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queues.js","sourceRoot":"","sources":["../../../../src/v3/types/queues.ts"],"names":[],"mappings":""}

package/dist/commonjs/v3/types/schemas.d.ts

@@ -2,6 +2,7 @@ export type SchemaZodEsque<TInput, TParsedInput> = {
     _input: TInput;
     _output: TParsedInput;
 };
+export declare function isSchemaZodEsque<TInput, TParsedInput>(schema: Schema): schema is SchemaZodEsque<TInput, TParsedInput>;
 export type SchemaValibotEsque<TInput, TParsedInput> = {
     schema: {
         _types?: {
@@ -10,10 +11,12 @@ export type SchemaValibotEsque<TInput, TParsedInput> = {
         };
     };
 };
+export declare function isSchemaValibotEsque<TInput, TParsedInput>(schema: Schema): schema is SchemaValibotEsque<TInput, TParsedInput>;
 export type SchemaArkTypeEsque<TInput, TParsedInput> = {
     inferIn: TInput;
     infer: TParsedInput;
 };
+export declare function isSchemaArkTypeEsque<TInput, TParsedInput>(schema: Schema): schema is SchemaArkTypeEsque<TInput, TParsedInput>;
 export type SchemaMyZodEsque<TInput> = {
     parse: (input: any) => TInput;
 };

package/dist/commonjs/v3/types/schemas.js

@@ -1,6 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSchemaZodEsque = isSchemaZodEsque;
+exports.isSchemaValibotEsque = isSchemaValibotEsque;
+exports.isSchemaArkTypeEsque = isSchemaArkTypeEsque;
 exports.getSchemaParseFn = getSchemaParseFn;
+function isSchemaZodEsque(schema) {
+    return (typeof schema === "object" &&
+        "_def" in schema &&
+        "parse" in schema &&
+        "parseAsync" in schema &&
+        "safeParse" in schema);
+}
+function isSchemaValibotEsque(schema) {
+    return typeof schema === "object" && "_types" in schema;
+}
+function isSchemaArkTypeEsque(schema) {
+    return typeof schema === "object" && "_inferIn" in schema && "_infer" in schema;
+}
 function getSchemaParseFn(procedureParser) {
     const parser = procedureParser;
     if (typeof parser === "function" && typeof parser.assert === "function") {

package/dist/commonjs/v3/types/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/v3/types/schemas.ts"],"names":[],"mappings":";;AA+EA,4CA4CC;AA5CD,SAAgB,gBAAgB,CAAQ,eAAuB;IAC7D,MAAM,MAAM,GAAG,eAAsB,CAAC;IAEtC,IAAI,OAAO,MAAM,KAAK,UAAU,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxE,8HAA8H;QAC9H,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,kCAAkC;QAClC,6BAA6B;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC5C,iBAAiB;QACjB,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACvC,iBAAiB;QACjB,iCAAiC;QACjC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC9C,iBAAiB;QACjB,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,yBAAyB;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,mBAAmB;QACnB,OAAO,CAAC,KAAK,EAAE,EAAE;YACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,KAAc,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/v3/types/schemas.ts"],"names":[],"mappings":";;AAKA,4CAUC;AAWD,oDAIC;AAOD,oDAIC;AA8DD,4CA4CC;AA9ID,SAAgB,gBAAgB,CAC9B,MAAc;IAEd,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,IAAI,MAAM;QAChB,OAAO,IAAI,MAAM;QACjB,YAAY,IAAI,MAAM;QACtB,WAAW,IAAI,MAAM,CACtB,CAAC;AACJ,CAAC;AAWD,SAAgB,oBAAoB,CAClC,MAAc;IAEd,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,QAAQ,IAAI,MAAM,CAAC;AAC1D,CAAC;AAOD,SAAgB,oBAAoB,CAClC,MAAc;IAEd,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,UAAU,IAAI,MAAM,IAAI,QAAQ,IAAI,MAAM,CAAC;AAClF,CAAC;AA8DD,SAAgB,gBAAgB,CAAQ,eAAuB;IAC7D,MAAM,MAAM,GAAG,eAAsB,CAAC;IAEtC,IAAI,OAAO,MAAM,KAAK,UAAU,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxE,8HAA8H;QAC9H,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,kCAAkC;QAClC,6BAA6B;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC5C,iBAAiB;QACjB,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACvC,iBAAiB;QACjB,iCAAiC;QACjC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC9C,iBAAiB;QACjB,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,yBAAyB;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACxC,mBAAmB;QACnB,OAAO,CAAC,KAAK,EAAE,EAAE;YACf,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,KAAc,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACnD,CAAC"}

package/dist/commonjs/v3/types/tasks.d.ts

@@ -1,21 +1,16 @@
 import { SerializableJson } from "../../schemas/json.js";
 import { TriggerApiRequestOptions } from "../apiClient/index.js";
+import { AnyOnCatchErrorHookFunction, OnCatchErrorHookFunction, OnCleanupHookFunction, OnCompleteHookFunction, OnFailureHookFunction, OnInitHookFunction, OnMiddlewareHookFunction, OnResumeHookFunction, OnStartHookFunction, OnSuccessHookFunction, OnWaitHookFunction } from "../lifecycleHooks/types.js";
 import { RunTags } from "../schemas/api.js";
 import { MachineCpu, MachineMemory, MachinePresetName, RetryOptions, TaskMetadata, TaskRunContext } from "../schemas/index.js";
-import { QueueOptions } from "../schemas/schemas.js";
 import { IdempotencyKey } from "./idempotencyKeys.js";
+import { QueueOptions } from "./queues.js";
 import { AnySchemaParseFn, inferSchemaIn, inferSchemaOut, Schema } from "./schemas.js";
-import { Prettify } from "./utils.js";
 import { inferToolParameters, ToolTaskParameters } from "./tools.js";
-type RequireOne<T, K extends keyof T> = {
-    [X in Exclude<keyof T, K>]?: T[X];
-} & {
-    [P in K]-?: T[P];
-};
-export type Queue = RequireOne<QueueOptions, "name">;
+import { Prettify } from "./utils.js";
+export type Queue = QueueOptions;
 export type TaskSchema = Schema;
 export type { inferSchemaIn } from "./schemas.js";
-type TaskRunConcurrencyOptions = Queue;
 export declare class SubtaskUnwrapError extends Error {
     readonly taskId: string;
     readonly runId: string;
@@ -49,6 +44,7 @@ export type InitFnParams = Prettify<{
 }>;
 export type StartFnParams = Prettify<{
     ctx: Context;
+    init?: InitOutput;
     /** Abort signal that is aborted when a task run exceeds it's maxDuration. Can be used to automatically cancel downstream requests */
     signal?: AbortSignal;
 }>;
@@ -70,14 +66,14 @@ export type HandleErrorModificationOptions = {
 export type HandleErrorResult = undefined | void | HandleErrorModificationOptions | Promise<undefined | void | HandleErrorModificationOptions>;
 export type HandleErrorArgs = {
     ctx: Context;
-    init: unknown;
+    init?: Record<string, unknown>;
     retry?: RetryOptions;
     retryAt?: Date;
     retryDelayInMs?: number;
     /** Abort signal that is aborted when a task run exceeds it's maxDuration. Can be used to automatically cancel downstream requests */
     signal?: AbortSignal;
 };
-export type HandleErrorFunction = (payload: any, error: unknown, params: HandleErrorArgs) => HandleErrorResult;
+export type HandleErrorFunction = AnyOnCatchErrorHookFunction;
 type CommonTaskOptions<TIdentifier extends string, TPayload = void, TOutput = unknown, TInitOutput extends InitOutput = any> = {
     /** An id for your task. This must be unique inside your project and not change between versions.  */
     id: TIdentifier;
@@ -122,7 +118,11 @@ type CommonTaskOptions<TIdentifier extends string, TPayload = void, TOutput = un
       });
      * ```
      */
-    queue?: QueueOptions;
+    queue?: {
+        name?: string;
+        concurrencyLimit?: number;
+        releaseConcurrencyOnWaitpoint?: boolean;
+    };
     /** Configure the spec of the [machine](https://trigger.dev/docs/machines) you want your task to run on.
      *
      * @example
@@ -178,16 +178,29 @@ type CommonTaskOptions<TIdentifier extends string, TPayload = void, TOutput = un
     run: (payload: TPayload, params: RunFnParams<TInitOutput>) => Promise<TOutput>;
     /**
      * init is called before the run function is called. It's useful for setting up any global state.
+     *
+     * @deprecated Use locals and middleware instead
      */
-    init?: (payload: TPayload, params: InitFnParams) => Promise<TInitOutput>;
+    init?: OnInitHookFunction<TPayload, TInitOutput>;
     /**
      * cleanup is called after the run function has completed.
+     *
+     * @deprecated Use middleware instead
      */
-    cleanup?: (payload: TPayload, params: RunFnParams<TInitOutput>) => Promise<void>;
+    cleanup?: OnCleanupHookFunction<TPayload, TInitOutput>;
     /**
      * handleError is called when the run function throws an error. It can be used to modify the error or return new retry options.
+     *
+     * @deprecated Use catchError instead
      */
-    handleError?: (payload: TPayload, error: unknown, params: HandleErrorFnParams<TInitOutput>) => HandleErrorResult;
+    handleError?: OnCatchErrorHookFunction<TPayload>;
+    /**
+     * catchError is called when the run function throws an error. It can be used to modify the error or return new retry options.
+     */
+    catchError?: OnCatchErrorHookFunction<TPayload>;
+    onResume?: OnResumeHookFunction<TPayload>;
+    onWait?: OnWaitHookFunction<TPayload>;
+    onComplete?: OnCompleteHookFunction<TPayload, TOutput>;
     /**
      * middleware allows you to run code "around" the run function. This can be useful for logging, metrics, or other cross-cutting concerns.
      *
@@ -205,19 +218,19 @@ type CommonTaskOptions<TIdentifier extends string, TPayload = void, TOutput = un
      * });
      * ```
      */
-    middleware?: (payload: TPayload, params: MiddlewareFnParams) => Promise<void>;
+    middleware?: OnMiddlewareHookFunction<TPayload>;
     /**
      * onStart is called the first time a task is executed in a run (not before every retry)
      */
-    onStart?: (payload: TPayload, params: StartFnParams) => Promise<void>;
+    onStart?: OnStartHookFunction<TPayload, TInitOutput>;
     /**
      * onSuccess is called after the run function has successfully completed.
      */
-    onSuccess?: (payload: TPayload, output: TOutput, params: SuccessFnParams<TInitOutput>) => Promise<void>;
+    onSuccess?: OnSuccessHookFunction<TPayload, TOutput, TInitOutput>;
     /**
      * onFailure is called after a task run has failed (meaning the run function threw an error and won't be retried anymore)
      */
-    onFailure?: (payload: TPayload, error: unknown, params: FailureFnParams<TInitOutput>) => Promise<void>;
+    onFailure?: OnFailureHookFunction<TPayload, TInitOutput>;
 };
 export type TaskOptions<TIdentifier extends string, TPayload = void, TOutput = unknown, TInitOutput extends InitOutput = any> = CommonTaskOptions<TIdentifier, TPayload, TOutput, TInitOutput>;
 export type TaskWithSchemaOptions<TIdentifier extends string, TSchema extends TaskSchema | undefined = undefined, TOutput = unknown, TInitOutput extends InitOutput = any> = CommonTaskOptions<TIdentifier, inferSchemaOut<TSchema>, TOutput, TInitOutput> & {
@@ -254,9 +267,7 @@ export type AnyBatchedRunHandle = BatchedRunHandle<string, any, any>;
  */
 export type BatchRunHandle<TTaskIdentifier extends string, TPayload, TOutput> = BrandedRun<{
     batchId: string;
-    isCached: boolean;
-    idempotencyKey?: string;
-    runs: Array<BatchedRunHandle<TTaskIdentifier, TPayload, TOutput>>;
+    runCount: number;
     publicAccessToken: string;
 }, TOutput, TPayload>;
 export type RunHandleOutput<TRunHandle> = TRunHandle extends RunHandle<string, any, infer TOutput> ? TOutput : never;
@@ -462,8 +473,20 @@ export type TriggerOptions = {
      * Specify a duration string like "1h", "10s", "30m", etc.
      */
     idempotencyKeyTTL?: string;
+    /**
+     * The maximum number of retry attempts for the task if it fails.
+     * If not specified, it will use the task or the default retry policy from your trigger.config file.
+     */
     maxAttempts?: number;
-    queue?: TaskRunConcurrencyOptions;
+    /**
+     * You can override the queue for the task. If a queue doesn't exist for the given name, the run will be in the PENDING_VERSION state until the queue is created..
+     */
+    queue?: string;
+    /**
+     * The `concurrencyKey` creates a copy of the queue for every unique value of the key.
+     * For example, if the queue (set when triggering or on the task) has a concurrency limit of 10,
+     * and you set the concurrency key to `userId`, then each user will have their own queue with a concurrency limit of 10.
+     */
     concurrencyKey?: string;
     /**
      * The delay before the task is executed. This can be a string like "1h" or a Date object.
@@ -492,6 +515,25 @@ export type TriggerOptions = {
      * **Note:** Runs in development have a default `ttl` of 10 minutes. You can override this by setting the `ttl` option.
      */
     ttl?: string | number;
+    /**
+     * If triggered at the same time, a higher priority run will be executed first.
+     *
+     The value is a time offset in seconds that determines the order of dequeuing.
+     * If you trigger two runs 9 seconds apart but the second one has `priority: 10`, it will be executed before the first one.
+     *
+     * @example
+     * ```ts
+     // no priority = 0
+     await myTask.trigger({ foo: "bar" });
+  
+     //... imagine 9s pass by
+  
+     // this run will start before the run above that was triggered 9s ago (with no priority)
+     await myTask.trigger({ foo: "bar" }, { priority: 10 });
+     ```
+     *
+     */
+    priority?: number;
     /**
      * Tags to attach to the run. Tags can be used to filter runs in the dashboard and using the SDK.
      *
@@ -538,23 +580,23 @@ export type TriggerOptions = {
      */
     version?: string;
 };
-export type TriggerAndWaitOptions = Omit<TriggerOptions, "idempotencyKey" | "idempotencyKeyTTL" | "version">;
-export type BatchTriggerOptions = {
-    idempotencyKey?: IdempotencyKey | string | string[];
-    idempotencyKeyTTL?: string;
+export type TriggerAndWaitOptions = Omit<TriggerOptions, "version"> & {
     /**
-     * When true, triggers tasks sequentially in batch order. This ensures ordering but may be slower,
-     * especially for large batches.
+     * If set to true, this will cause the waitpoint to release the current run from the queue's concurrency.
      *
-     * When false (default), triggers tasks in parallel for better performance, but order is not guaranteed.
-     *
-     * Note: This only affects the order of run creation, not the actual task execution.
+     * This is useful if you want to allow other runs to execute while the child task is executing
      *
      * @default false
      */
-    triggerSequentially?: boolean;
+    releaseConcurrency?: boolean;
 };
-export type BatchTriggerAndWaitOptions = {
+export type BatchTriggerOptions = {
+    /**
+     * If no idempotencyKey is set on an individual item in the batch, it will use this key on each item + the array index.
+     * This is useful to prevent work being done again if the task has to retry.
+     */
+    idempotencyKey?: IdempotencyKey | string | string[];
+    idempotencyKeyTTL?: string;
     /**
      * When true, triggers tasks sequentially in batch order. This ensures ordering but may be slower,
      * especially for large batches.
@@ -567,6 +609,7 @@ export type BatchTriggerAndWaitOptions = {
      */
     triggerSequentially?: boolean;
 };
+export type BatchTriggerAndWaitOptions = BatchTriggerOptions;
 export type TaskMetadataWithFunctions = TaskMetadata & {
     fns: {
         run: (payload: any, params: RunFnParams<any>) => Promise<any>;

package/dist/commonjs/v3/types/tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../../src/v3/types/tasks.ts"],"names":[],"mappings":";;;AA6BA,MAAa,kBAAmB,SAAQ,KAAK;IAC3B,MAAM,CAAS;IACf,KAAK,CAAS;IACd,KAAK,CAAW;IAEhC,YAAY,MAAc,EAAE,KAAa,EAAE,YAAqB;QAC9D,IAAI,YAAY,YAAY,KAAK,EAAE,CAAC;YAClC,KAAK,CAAC,YAAY,MAAM,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;YAC1B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;YACjC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAnBD,gDAmBC;AAED,MAAa,cAAoD,SAAQ,OAExE;IAUoB;IATnB,YACE,QAOS,EACQ,MAAmB;QAEpC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAa;IAGtC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO,MAAM,CAAC,MAAM,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA1BD,wCA0BC"}
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../../src/v3/types/tasks.ts"],"names":[],"mappings":";;;AAkCA,MAAa,kBAAmB,SAAQ,KAAK;IAC3B,MAAM,CAAS;IACf,KAAK,CAAS;IACd,KAAK,CAAW;IAEhC,YAAY,MAAc,EAAE,KAAa,EAAE,YAAqB;QAC9D,IAAI,YAAY,YAAY,KAAK,EAAE,CAAC;YAClC,KAAK,CAAC,YAAY,MAAM,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;YAC1B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;YACjC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAnBD,gDAmBC;AAED,MAAa,cAAoD,SAAQ,OAExE;IAUoB;IATnB,YACE,QAOS,EACQ,MAAmB;QAEpC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAa;IAGtC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO,MAAM,CAAC,MAAM,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA1BD,wCA0BC"}

package/dist/commonjs/v3/utils/durations.d.ts

@@ -3,6 +3,7 @@ type DurationOptions = {
     style?: "long" | "short";
     maxDecimalPoints?: number;
     units?: Unit[];
+    maxUnits?: number;
 };
 export declare function formatDuration(start?: Date | null, end?: Date | null, options?: DurationOptions): string;
 export declare function nanosecondsToMilliseconds(nanoseconds: number): number;

package/dist/commonjs/v3/utils/durations.js

@@ -38,7 +38,7 @@ function formatDurationMilliseconds(milliseconds, options) {
                 ? belowOneSecondUnits
                 : aboveOneSecondUnits,
         maxDecimalPoints: options?.maxDecimalPoints ?? 1,
-        largest: 2,
+        largest: options?.maxUnits ?? 2,
     });
     if (!options) {
         return duration;

package/dist/commonjs/v3/utils/durations.js.map

@@ -1 +1 @@
-{"version":3,"file":"durations.js","sourceRoot":"","sources":["../../../../src/v3/utils/durations.ts"],"names":[],"mappings":";;;;;AAYA,wCAUC;AAED,8DAEC;AAED,8DAEC;AAED,8DAEC;AAKD,gEAuCC;AAED,oDAQC;AAxFD,0EAA2D;AAE3D,SAAS,cAAc,CAAC,KAAW,EAAE,KAAW;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;AACrD,CAAC;AAQD,SAAgB,cAAc,CAC5B,KAAmB,EACnB,GAAiB,EACjB,OAAyB;IAEzB,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,0BAA0B,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,SAAgB,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,WAAW,GAAG,SAAS,CAAC;AACjC,CAAC;AAED,SAAgB,yBAAyB,CAAC,YAAoB;IAC5D,OAAO,YAAY,GAAG,SAAS,CAAC;AAClC,CAAC;AAED,SAAgB,yBAAyB,CAAC,WAAmB,EAAE,OAAyB;IACtF,OAAO,0BAA0B,CAAC,yBAAyB,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAW,CAAC;AAC3D,MAAM,mBAAmB,GAAG,CAAC,IAAI,CAAW,CAAC;AAE7C,SAAgB,0BAA0B,CACxC,YAAoB,EACpB,OAAyB;IAEzB,IAAI,QAAQ,GAAG,IAAA,2BAAgB,EAAC,YAAY,EAAE;QAC5C,KAAK,EAAE,OAAO,EAAE,KAAK;YACnB,CAAC,CAAC,OAAO,CAAC,KAAK;YACf,CAAC,CAAC,YAAY,GAAG,IAAI;gBACrB,CAAC,CAAC,mBAAmB;gBACrB,CAAC,CAAC,mBAAmB;QACvB,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,IAAI,CAAC;QAChD,OAAO,EAAE,CAAC;KACX,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,QAAQ,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,KAAK,OAAO;YACV,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;YACnD,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;YAClD,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC7C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC5C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC7C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;YAC5C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC3C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACzC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC3C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC1C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC7C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC5C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC3C,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,oBAAoB,CAAC,YAAoB;IACvD,IAAI,QAAQ,GAAG,IAAA,2BAAgB,EAAC,YAAY,EAAE;QAC5C,gBAAgB,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,CAAC,GAAG,CAAC;KACb,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"durations.js","sourceRoot":"","sources":["../../../../src/v3/utils/durations.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/v3/utils/globals.d.ts

@@ -1,9 +1,11 @@
 import { ApiClientConfiguration } from "../apiClientManager/types.js";
 import { Clock } from "../clock/clock.js";
+import { LifecycleHooksManager } from "../lifecycleHooks/types.js";
+import { LocalsManager } from "../locals/types.js";
+import { ResourceCatalog } from "../resource-catalog/catalog.js";
 import { RunMetadataManager } from "../runMetadata/types.js";
 import type { RuntimeManager } from "../runtime/manager.js";
 import { RunTimelineMetricsManager } from "../runTimelineMetrics/types.js";
-import { TaskCatalog } from "../task-catalog/catalog.js";
 import { TaskContext } from "../taskContext/types.js";
 import { TimeoutManager } from "../timeout/types.js";
 import { UsageManager } from "../usage/types.js";
@@ -16,12 +18,14 @@ type TriggerDotDevGlobalAPI = {
     logger?: any;
     clock?: Clock;
     usage?: UsageManager;
-    ["task-catalog"]?: TaskCatalog;
+    ["resource-catalog"]?: ResourceCatalog;
     ["task-context"]?: TaskContext;
     ["api-client"]?: ApiClientConfiguration;
     ["run-metadata"]?: RunMetadataManager;
     ["timeout"]?: TimeoutManager;
     ["wait-until"]?: WaitUntilManager;
     ["run-timeline-metrics"]?: RunTimelineMetricsManager;
+    ["lifecycle-hooks"]?: LifecycleHooksManager;
+    ["locals"]?: LocalsManager;
 };
 export {};

package/dist/commonjs/v3/utils/globals.js.map

@@ -1 +1 @@
-{"version":3,"file":"globals.js","sourceRoot":"","sources":["../../../../src/v3/utils/globals.ts"],"names":[],"mappings":";;AAiBA,wCAgBC;AAED,8BAIC;AAED,4CAMC;AApCD,+CAA4C;AAE5C,MAAM,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAEpE,MAAM,OAAO,GAAG,yBAAkC,CAAC;AAEnD,SAAgB,cAAc,CAC5B,IAAU,EACV,QAAsC,EACtC,aAAa,GAAG,KAAK;IAErB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,0BAA0B,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9F,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,yCAAyC;QACzC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,yDAAyD,IAAI,EAAE,CAAC,CAAC;QACvF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;IAErB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,SAAS,CACvB,IAAU;IAEV,OAAO,OAAO,CAAC,0BAA0B,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAkC;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEhD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../../../../src/v3/utils/globals.ts"],"names":[],"mappings":";;AAkBA,wCAgBC;AAED,8BAIC;AAED,4CAMC;AApCD,+CAA4C;AAE5C,MAAM,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAEpE,MAAM,OAAO,GAAG,yBAAkC,CAAC;AAEnD,SAAgB,cAAc,CAC5B,IAAU,EACV,QAAsC,EACtC,aAAa,GAAG,KAAK;IAErB,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,0BAA0B,CAAC,GAAG,OAAO,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9F,IAAI,CAAC,aAAa,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,yCAAyC;QACzC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,yDAAyD,IAAI,EAAE,CAAC,CAAC;QACvF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC;IAErB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,SAAS,CACvB,IAAU;IAEV,OAAO,OAAO,CAAC,0BAA0B,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,gBAAgB,CAAC,IAAkC;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEhD,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/commonjs/v3/utils/heartbeat.d.ts

@@ -0,0 +1,21 @@
+type HeartbeatServiceOptions = {
+    heartbeat: () => Promise<void>;
+    intervalMs?: number;
+    leadingEdge?: boolean;
+    onError?: (error: unknown) => Promise<void>;
+};
+export declare class HeartbeatService {
+    #private;
+    private _heartbeat;
+    private _intervalMs;
+    private _nextHeartbeat;
+    private _leadingEdge;
+    private _isHeartbeating;
+    private _onError?;
+    constructor(opts: HeartbeatServiceOptions);
+    start(): void;
+    stop(): void;
+    resetCurrentInterval(): void;
+    updateInterval(intervalMs: number): void;
+}
+export {};

package/dist/commonjs/v3/utils/heartbeat.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeartbeatService = void 0;
+class HeartbeatService {
+    _heartbeat;
+    _intervalMs;
+    _nextHeartbeat;
+    _leadingEdge;
+    _isHeartbeating;
+    _onError;
+    constructor(opts) {
+        this._heartbeat = opts.heartbeat;
+        this._intervalMs = opts.intervalMs ?? 45_000;
+        this._nextHeartbeat = undefined;
+        this._leadingEdge = opts.leadingEdge ?? false;
+        this._isHeartbeating = false;
+        this._onError = opts.onError;
+    }
+    start() {
+        if (this._isHeartbeating) {
+            return;
+        }
+        this._isHeartbeating = true;
+        if (this._leadingEdge) {
+            this.#doHeartbeat();
+        }
+        else {
+            this.#scheduleNextHeartbeat();
+        }
+    }
+    stop() {
+        if (!this._isHeartbeating) {
+            return;
+        }
+        this._isHeartbeating = false;
+        this.#clearNextHeartbeat();
+    }
+    resetCurrentInterval() {
+        if (!this._isHeartbeating) {
+            return;
+        }
+        this.#clearNextHeartbeat();
+        this.#scheduleNextHeartbeat();
+    }
+    updateInterval(intervalMs) {
+        this._intervalMs = intervalMs;
+        this.resetCurrentInterval();
+    }
+    #doHeartbeat = async () => {
+        this.#clearNextHeartbeat();
+        if (!this._isHeartbeating) {
+            return;
+        }
+        try {
+            await this._heartbeat();
+        }
+        catch (error) {
+            if (this._onError) {
+                try {
+                    await this._onError(error);
+                }
+                catch (error) {
+                    console.error("Error handling heartbeat error", error);
+                }
+            }
+        }
+        this.#scheduleNextHeartbeat();
+    };
+    #clearNextHeartbeat() {
+        if (this._nextHeartbeat) {
+            clearTimeout(this._nextHeartbeat);
+        }
+    }
+    #scheduleNextHeartbeat() {
+        this._nextHeartbeat = setTimeout(this.#doHeartbeat, this._intervalMs);
+    }
+}
+exports.HeartbeatService = HeartbeatService;
+//# sourceMappingURL=heartbeat.js.map

package/dist/commonjs/v3/utils/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../../../src/v3/utils/heartbeat.ts"],"names":[],"mappings":";;;AAOA,MAAa,gBAAgB;IACnB,UAAU,CAAsB;IAChC,WAAW,CAAS;IACpB,cAAc,CAA6B;IAC3C,YAAY,CAAU;IACtB,eAAe,CAAU;IACzB,QAAQ,CAAqC;IAErD,YAAY,IAA6B;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC;QAC7C,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC;QAC9C,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAE5B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED,oBAAoB;QAClB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3B,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC;IAED,cAAc,CAAC,UAAkB;QAC/B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC9B,CAAC;IAED,YAAY,GAAG,KAAK,IAAI,EAAE;QACxB,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAE3B,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC7B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAChC,CAAC,CAAC;IAEF,mBAAmB;QACjB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,sBAAsB;QACpB,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACxE,CAAC;CACF;AArFD,4CAqFC"}

package/dist/commonjs/v3/utils/imageRef.d.ts

@@ -0,0 +1,8 @@
+export type DockerImageParts = {
+    registry?: string;
+    repo: string;
+    tag?: string;
+    digest?: string;
+};
+export declare function parseDockerImageReference(imageReference: string): DockerImageParts;
+export declare function rebuildDockerImageReference(parts: DockerImageParts): string;

package/dist/commonjs/v3/utils/imageRef.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDockerImageReference = parseDockerImageReference;
+exports.rebuildDockerImageReference = rebuildDockerImageReference;
+function parseDockerImageReference(imageReference) {
+    const parts = { repo: "" }; // Initialize with an empty repo
+    // Splitting by '@' to separate the digest (if exists)
+    const atSplit = imageReference.split("@");
+    if (atSplit.length > 1) {
+        parts.digest = atSplit[1];
+        imageReference = atSplit[0];
+    }
+    // Splitting by ':' to separate the tag (if exists) and to ensure it's not part of a port
+    let colonSplit = imageReference.split(":");
+    if (colonSplit.length > 2 ||
+        (colonSplit.length === 2 && !colonSplit[1].includes("/"))) {
+        // It's a tag if there's no '/' in the second part (after colon), or there are more than 2 parts (implying a port number in registry)
+        parts.tag = colonSplit.pop(); // The last part is the tag
+        imageReference = colonSplit.join(":"); // Join back in case it was a port number
+    }
+    // Check for registry
+    let slashIndex = imageReference.indexOf("/");
+    if (slashIndex !== -1) {
+        let potentialRegistry = imageReference.substring(0, slashIndex);
+        // Validate if the first part is a valid hostname-like string (registry), otherwise treat the entire string as the repo
+        if (potentialRegistry.includes(".") ||
+            potentialRegistry === "localhost" ||
+            potentialRegistry.includes(":")) {
+            parts.registry = potentialRegistry;
+            parts.repo = imageReference.substring(slashIndex + 1);
+        }
+        else {
+            parts.repo = imageReference; // No valid registry found, treat as repo
+        }
+    }
+    else {
+        parts.repo = imageReference; // Only repo is present
+    }
+    return parts;
+}
+function rebuildDockerImageReference(parts) {
+    let imageReference = "";
+    if (parts.registry) {
+        imageReference += `${parts.registry}/`;
+    }
+    imageReference += parts.repo; // Repo is now guaranteed to be defined
+    if (parts.tag) {
+        imageReference += `:${parts.tag}`;
+    }
+    if (parts.digest) {
+        imageReference += `@${parts.digest}`;
+    }
+    return imageReference;
+}
+//# sourceMappingURL=imageRef.js.map

package/dist/commonjs/v3/utils/imageRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageRef.js","sourceRoot":"","sources":["../../../../src/v3/utils/imageRef.ts"],"names":[],"mappings":";;AAOA,8DAyCC;AAED,kEAkBC;AA7DD,SAAgB,yBAAyB,CAAC,cAAsB;IAC9D,MAAM,KAAK,GAAqB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,gCAAgC;IAE9E,sDAAsD;IACtD,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,cAAc,GAAG,OAAO,CAAC,CAAC,CAAW,CAAC;IACxC,CAAC;IAED,yFAAyF;IACzF,IAAI,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,IACE,UAAU,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAE,UAAU,CAAC,CAAC,CAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EACrE,CAAC;QACD,qIAAqI;QACrI,KAAK,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,2BAA2B;QACzD,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,yCAAyC;IAClF,CAAC;IAED,qBAAqB;IACrB,IAAI,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,IAAI,iBAAiB,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAChE,uHAAuH;QACvH,IACE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC/B,iBAAiB,KAAK,WAAW;YACjC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAC/B,CAAC;YACD,KAAK,CAAC,QAAQ,GAAG,iBAAiB,CAAC;YACnC,KAAK,CAAC,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,GAAG,cAAc,CAAC,CAAC,yCAAyC;QACxE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,GAAG,cAAc,CAAC,CAAC,uBAAuB;IACtD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,2BAA2B,CAAC,KAAuB;IACjE,IAAI,cAAc,GAAG,EAAE,CAAC;IAExB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,cAAc,IAAI,GAAG,KAAK,CAAC,QAAQ,GAAG,CAAC;IACzC,CAAC;IAED,cAAc,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,uCAAuC;IAErE,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,cAAc,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,cAAc,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;IACvC,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

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

@@ -4,8 +4,8 @@ export { PreciseWallClock as DurableClock } from "../clock/preciseWallClock.js";
 export { getEnvVar, getNumberEnvVar } from "../utils/getEnv.js";
 export { OtelTaskLogger, logLevels } from "../logger/taskLogger.js";
 export { ConsoleInterceptor } from "../consoleInterceptor.js";
-export { TracingSDK, type TracingDiagnosticLogLevel, recordSpanException } from "../otel/index.js";
-export { StandardTaskCatalog } from "../task-catalog/standardTaskCatalog.js";
+export { TracingSDK, type TracingDiagnosticLogLevel, recordSpanException, carrierFromContext, } from "../otel/index.js";
+export { StandardResourceCatalog } from "../resource-catalog/standardResourceCatalog.js";
 export { TaskContextSpanProcessor, TaskContextLogProcessor, } from "../taskContext/otelProcessors.js";
 export * from "../usage-api.js";
 export { DevUsageManager } from "../usage/devUsageManager.js";
@@ -13,4 +13,10 @@ export { ProdUsageManager, type ProdUsageManagerOptions } from "../usage/prodUsa
 export { UsageTimeoutManager } from "../timeout/usageTimeoutManager.js";
 export { StandardMetadataManager } from "../runMetadata/manager.js";
 export { StandardWaitUntilManager } from "../waitUntil/manager.js";
+export { ManagedRuntimeManager } from "../runtime/managedRuntimeManager.js";
+export * from "../runEngineWorker/index.js";
 export { StandardRunTimelineMetricsManager } from "../runTimelineMetrics/runTimelineMetricsManager.js";
+export { WarmStartClient, type WarmStartClientOptions } from "../workers/warmStartClient.js";
+export { StandardLifecycleHooksManager } from "../lifecycleHooks/manager.js";
+export { StandardLocalsManager } from "../locals/manager.js";
+export { populateEnv } from "./populateEnv.js";