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

package/dist/commonjs/v3/workers/taskExecutor.js

@@ -6,9 +6,11 @@ const version_js_1 = require("../../version.js");
 const errors_js_1 = require("../errors.js");
 const index_js_1 = require("../index.js");
 const index_js_2 = require("../otel/index.js");
+const run_timeline_metrics_api_js_1 = require("../run-timeline-metrics-api.js");
 const index_js_3 = require("../schemas/index.js");
 const semanticInternalAttributes_js_1 = require("../semanticInternalAttributes.js");
 const task_context_api_js_1 = require("../task-context-api.js");
+const tryCatch_js_1 = require("../tryCatch.js");
 const ioSerialization_js_1 = require("../utils/ioSerialization.js");
 const retries_js_1 = require("../utils/retries.js");
 class TaskExecutor {
@@ -16,17 +18,17 @@ class TaskExecutor {
     _tracingSDK;
     _tracer;
     _consoleInterceptor;
-    _importedConfig;
-    _handleErrorFn;
+    _retries;
+    _isWarmStart;
     constructor(task, options) {
         this.task = task;
         this._tracingSDK = options.tracingSDK;
         this._tracer = options.tracer;
         this._consoleInterceptor = options.consoleInterceptor;
-        this._importedConfig = options.config;
-        this._handleErrorFn = options.handleErrorFn;
+        this._retries = options.retries;
+        this._isWarmStart = options.isWarmStart;
     }
-    async execute(execution, worker, traceContext, usage, signal) {
+    async execute(execution, worker, traceContext, signal, isWarmStart) {
         const ctx = index_js_3.TaskRunContext.parse(execution);
         const attemptMessage = `Attempt ${execution.attempt.number}`;
         const originalPacket = {
@@ -36,6 +38,7 @@ class TaskExecutor {
         task_context_api_js_1.taskContext.setGlobalTaskContext({
             ctx,
             worker,
+            isWarmStart: isWarmStart ?? this._isWarmStart,
         });
         if (execution.run.metadata) {
             index_js_1.runMetadata.enterWithMetadata(execution.run.metadata);
@@ -49,73 +52,49 @@ class TaskExecutor {
             return await this._consoleInterceptor.intercept(console, async () => {
                 let parsedPayload;
                 let initOutput;
-                try {
+                const [inputError, payloadResult] = await (0, tryCatch_js_1.tryCatch)(run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "payload", async () => {
                     const payloadPacket = await (0, ioSerialization_js_1.conditionallyImportPacket)(originalPacket, this._tracer);
-                    parsedPayload = await (0, ioSerialization_js_1.parsePacket)(payloadPacket);
-                }
-                catch (inputError) {
+                    return await (0, ioSerialization_js_1.parsePacket)(payloadPacket);
+                }));
+                if (inputError) {
                     (0, index_js_2.recordSpanException)(span, inputError);
-                    return {
-                        ok: false,
-                        id: execution.run.id,
-                        error: {
-                            type: "INTERNAL_ERROR",
-                            code: index_js_3.TaskRunErrorCodes.TASK_INPUT_ERROR,
-                            message: inputError instanceof Error
-                                ? `${inputError.name}: ${inputError.message}`
-                                : typeof inputError === "string"
-                                    ? inputError
-                                    : undefined,
-                            stackTrace: inputError instanceof Error ? inputError.stack : undefined,
-                        },
-                    };
+                    return this.#internalErrorResult(execution, index_js_3.TaskRunErrorCodes.TASK_INPUT_ERROR, inputError);
                 }
-                try {
-                    parsedPayload = await this.#parsePayload(parsedPayload);
-                    if (execution.attempt.number === 1) {
-                        await this.#callOnStartFunctions(parsedPayload, ctx, signal);
-                    }
-                    initOutput = await this.#callInitFunctions(parsedPayload, ctx, signal);
-                    const output = await this.#callRun(parsedPayload, ctx, initOutput, signal);
-                    await this.#callOnSuccessFunctions(parsedPayload, output, ctx, initOutput, signal);
-                    try {
-                        const stringifiedOutput = await (0, ioSerialization_js_1.stringifyIO)(output);
-                        const finalOutput = await (0, ioSerialization_js_1.conditionallyExportPacket)(stringifiedOutput, `${execution.attempt.id}/output`, this._tracer);
-                        const attributes = await (0, ioSerialization_js_1.createPacketAttributes)(finalOutput, semanticInternalAttributes_js_1.SemanticInternalAttributes.OUTPUT, semanticInternalAttributes_js_1.SemanticInternalAttributes.OUTPUT_TYPE);
-                        if (attributes) {
-                            span.setAttributes(attributes);
+                parsedPayload = await this.#parsePayload(payloadResult);
+                index_js_1.lifecycleHooks.registerOnWaitHookListener(async (wait) => {
+                    await this.#callOnWaitFunctions(wait, parsedPayload, ctx, initOutput, signal);
+                });
+                index_js_1.lifecycleHooks.registerOnResumeHookListener(async (wait) => {
+                    await this.#callOnResumeFunctions(wait, parsedPayload, ctx, initOutput, signal);
+                });
+                const executeTask = async (payload) => {
+                    const [runError, output] = await (0, tryCatch_js_1.tryCatch)((async () => {
+                        initOutput = await this.#callInitFunctions(payload, ctx, signal);
+                        if (execution.attempt.number === 1) {
+                            await this.#callOnStartFunctions(payload, ctx, initOutput, signal);
+                        }
+                        try {
+                            return await this.#callRun(payload, ctx, initOutput, signal);
+                        }
+                        catch (error) {
+                            if ((0, errors_js_1.isCompleteTaskWithOutput)(error)) {
+                                return error.output;
+                            }
+                            throw error;
+                        }
+                    })());
+                    if (runError) {
+                        const [handleErrorError, handleErrorResult] = await (0, tryCatch_js_1.tryCatch)(this.#handleError(execution, runError, payload, ctx, initOutput, signal));
+                        if (handleErrorError) {
+                            (0, index_js_2.recordSpanException)(span, handleErrorError);
+                            return this.#internalErrorResult(execution, index_js_3.TaskRunErrorCodes.HANDLE_ERROR_ERROR, handleErrorError);
                         }
-                        return {
-                            ok: true,
-                            id: execution.run.id,
-                            output: finalOutput.data,
-                            outputType: finalOutput.dataType,
-                        };
-                    }
-                    catch (outputError) {
-                        (0, index_js_2.recordSpanException)(span, outputError);
-                        return {
-                            ok: false,
-                            id: execution.run.id,
-                            error: {
-                                type: "INTERNAL_ERROR",
-                                code: index_js_3.TaskRunErrorCodes.TASK_OUTPUT_ERROR,
-                                message: outputError instanceof Error
-                                    ? outputError.message
-                                    : typeof outputError === "string"
-                                        ? outputError
-                                        : undefined,
-                            },
-                        };
-                    }
-                }
-                catch (runError) {
-                    try {
-                        const handleErrorResult = await this.#handleError(execution, runError, parsedPayload, ctx, initOutput, signal);
                         (0, index_js_2.recordSpanException)(span, handleErrorResult.error ?? runError);
                         if (handleErrorResult.status !== "retry") {
-                            await this.#callOnFailureFunctions(parsedPayload, handleErrorResult.error ?? runError, ctx, initOutput, signal);
+                            await this.#callOnFailureFunctions(payload, handleErrorResult.error ?? runError, ctx, initOutput, signal);
+                            await this.#callOnCompleteFunctions(payload, { ok: false, error: handleErrorResult.error ?? runError }, ctx, initOutput, signal);
                         }
+                        await this.#cleanupAndWaitUntil(payload, ctx, initOutput, signal);
                         return {
                             id: execution.run.id,
                             ok: false,
@@ -126,160 +105,483 @@ class TaskExecutor {
                             skippedRetrying: handleErrorResult.status === "skipped",
                         };
                     }
-                    catch (handleErrorError) {
-                        (0, index_js_2.recordSpanException)(span, handleErrorError);
-                        return {
-                            ok: false,
-                            id: execution.run.id,
-                            error: {
-                                type: "INTERNAL_ERROR",
-                                code: index_js_3.TaskRunErrorCodes.HANDLE_ERROR_ERROR,
-                                message: handleErrorError instanceof Error
-                                    ? handleErrorError.message
-                                    : typeof handleErrorError === "string"
-                                        ? handleErrorError
-                                        : undefined,
-                            },
-                        };
+                    const [outputError, stringifiedOutput] = await (0, tryCatch_js_1.tryCatch)((0, ioSerialization_js_1.stringifyIO)(output));
+                    if (outputError) {
+                        (0, index_js_2.recordSpanException)(span, outputError);
+                        await this.#cleanupAndWaitUntil(payload, ctx, initOutput, signal);
+                        return this.#internalErrorResult(execution, index_js_3.TaskRunErrorCodes.TASK_OUTPUT_ERROR, outputError);
                     }
-                }
-                finally {
-                    await this.#callTaskCleanup(parsedPayload, ctx, initOutput, signal);
-                    await this.#blockForWaitUntil();
-                }
+                    const [exportError, finalOutput] = await (0, tryCatch_js_1.tryCatch)((0, ioSerialization_js_1.conditionallyExportPacket)(stringifiedOutput, `${execution.attempt.id}/output`, this._tracer));
+                    if (exportError) {
+                        (0, index_js_2.recordSpanException)(span, exportError);
+                        await this.#cleanupAndWaitUntil(payload, ctx, initOutput, signal);
+                        return this.#internalErrorResult(execution, index_js_3.TaskRunErrorCodes.TASK_OUTPUT_ERROR, exportError);
+                    }
+                    const [attrError, attributes] = await (0, tryCatch_js_1.tryCatch)((0, ioSerialization_js_1.createPacketAttributes)(finalOutput, semanticInternalAttributes_js_1.SemanticInternalAttributes.OUTPUT, semanticInternalAttributes_js_1.SemanticInternalAttributes.OUTPUT_TYPE));
+                    if (!attrError && attributes) {
+                        span.setAttributes(attributes);
+                    }
+                    await this.#callOnSuccessFunctions(payload, output, ctx, initOutput, signal);
+                    await this.#callOnCompleteFunctions(payload, { ok: true, data: output }, ctx, initOutput, signal);
+                    await this.#cleanupAndWaitUntil(payload, ctx, initOutput, signal);
+                    return {
+                        ok: true,
+                        id: execution.run.id,
+                        output: finalOutput.data,
+                        outputType: finalOutput.dataType,
+                    };
+                };
+                const globalMiddlewareHooks = index_js_1.lifecycleHooks.getGlobalMiddlewareHooks();
+                const taskMiddlewareHook = index_js_1.lifecycleHooks.getTaskMiddlewareHook(this.task.id);
+                const middlewareHooks = [
+                    ...globalMiddlewareHooks,
+                    taskMiddlewareHook ? { id: this.task.id, fn: taskMiddlewareHook } : undefined,
+                ].filter(Boolean);
+                return await this.#executeTaskWithMiddlewareHooks(parsedPayload, ctx, execution, middlewareHooks, executeTask, signal);
             });
         }, {
             kind: api_1.SpanKind.CONSUMER,
             attributes: {
                 [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "attempt",
+                [semanticInternalAttributes_js_1.SemanticInternalAttributes.ENTITY_TYPE]: "attempt",
                 [semanticInternalAttributes_js_1.SemanticInternalAttributes.SPAN_ATTEMPT]: true,
+                ...(execution.attempt.number === 1
+                    ? run_timeline_metrics_api_js_1.runTimelineMetrics.convertMetricsToSpanAttributes()
+                    : {}),
+                ...(execution.environment.type !== "DEVELOPMENT"
+                    ? {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_VARIANT]: this._isWarmStart
+                            ? index_js_3.WARM_VARIANT
+                            : index_js_3.COLD_VARIANT,
+                    }
+                    : {}),
             },
+            events: execution.attempt.number === 1
+                ? run_timeline_metrics_api_js_1.runTimelineMetrics.convertMetricsToSpanEvents()
+                : undefined,
         }, this._tracer.extractContext(traceContext), signal);
         return { result };
     }
+    async #executeTaskWithMiddlewareHooks(payload, ctx, execution, hooks, executeTask, signal) {
+        let output;
+        let executeError;
+        const runner = hooks.reduceRight((next, hook) => {
+            return async () => {
+                await this._tracer.startActiveSpan("middleware()", async (span) => {
+                    await hook.fn({ payload, ctx, signal, task: this.task.id, next });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-middleware",
+                        ...this.#lifecycleHookAccessoryAttributes(hook.name),
+                    },
+                });
+            };
+        }, async () => {
+            const [error, result] = await (0, tryCatch_js_1.tryCatch)(executeTask(payload));
+            if (error) {
+                executeError = error;
+            }
+            else {
+                output = result;
+            }
+        });
+        const [runnerError] = await (0, tryCatch_js_1.tryCatch)(runner());
+        if (runnerError) {
+            return this.#internalErrorResult(execution, index_js_3.TaskRunErrorCodes.TASK_MIDDLEWARE_ERROR, runnerError);
+        }
+        if (executeError) {
+            throw executeError;
+        }
+        return output;
+    }
     async #callRun(payload, ctx, init, signal) {
         const runFn = this.task.fns.run;
-        const middlewareFn = this.task.fns.middleware;
         if (!runFn) {
             throw new Error("Task does not have a run function");
         }
-        if (!middlewareFn) {
-            return runFn(payload, { ctx, init, signal });
+        // Create a promise that rejects when the signal aborts
+        const abortPromise = signal
+            ? new Promise((_, reject) => {
+                signal.addEventListener("abort", () => {
+                    const maxDuration = ctx.run.maxDuration;
+                    reject(new errors_js_1.InternalError({
+                        code: index_js_3.TaskRunErrorCodes.MAX_DURATION_EXCEEDED,
+                        message: `Run exceeded maximum compute time (maxDuration) of ${maxDuration} seconds`,
+                    }));
+                });
+            })
+            : undefined;
+        return run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "run", async () => {
+            return await this._tracer.startActiveSpan("run()", async (span) => {
+                if (abortPromise) {
+                    // Race between the run function and the abort promise
+                    return await Promise.race([runFn(payload, { ctx, init, signal }), abortPromise]);
+                }
+                return await runFn(payload, { ctx, init, signal });
+            }, {
+                attributes: { [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-fn-run" },
+            });
+        });
+    }
+    async #callOnWaitFunctions(wait, payload, ctx, initOutput, signal) {
+        const globalWaitHooks = index_js_1.lifecycleHooks.getGlobalWaitHooks();
+        const taskWaitHook = index_js_1.lifecycleHooks.getTaskWaitHook(this.task.id);
+        if (globalWaitHooks.length === 0 && !taskWaitHook) {
+            return;
         }
-        return middlewareFn(payload, {
-            ctx,
-            signal,
-            next: async () => runFn(payload, { ctx, init, signal }),
+        const result = await run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "onWait", async () => {
+            for (const hook of globalWaitHooks) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onWait()", async (span) => {
+                    await hook.fn({ payload, ctx, signal, task: this.task.id, wait, init: initOutput });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onWait",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes(hook.name),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
+            if (taskWaitHook) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onWait()", async (span) => {
+                    await taskWaitHook({
+                        payload,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        wait,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onWait",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes("task"),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
         });
     }
-    async #callInitFunctions(payload, ctx, signal) {
-        await this.#callConfigInit(payload, ctx, signal);
-        const initFn = this.task.fns.init;
-        if (!initFn) {
-            return {};
+    async #callOnResumeFunctions(wait, payload, ctx, initOutput, signal) {
+        const globalResumeHooks = index_js_1.lifecycleHooks.getGlobalResumeHooks();
+        const taskResumeHook = index_js_1.lifecycleHooks.getTaskResumeHook(this.task.id);
+        if (globalResumeHooks.length === 0 && !taskResumeHook) {
+            return;
         }
-        return this._tracer.startActiveSpan("init", async (span) => {
-            return await initFn(payload, { ctx, signal });
-        }, {
-            attributes: {
-                [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "function",
-            },
+        const result = await run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "onResume", async () => {
+            for (const hook of globalResumeHooks) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onResume()", async (span) => {
+                    await hook.fn({ payload, ctx, signal, task: this.task.id, wait, init: initOutput });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onResume",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes(hook.name),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
+            if (taskResumeHook) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onResume()", async (span) => {
+                    await taskResumeHook({
+                        payload,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        wait,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onResume",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes("task"),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
         });
     }
-    async #callConfigInit(payload, ctx, signal) {
-        const initFn = this._importedConfig?.init;
-        if (!initFn) {
+    async #callInitFunctions(payload, ctx, signal) {
+        const globalInitHooks = index_js_1.lifecycleHooks.getGlobalInitHooks();
+        const taskInitHook = index_js_1.lifecycleHooks.getTaskInitHook(this.task.id);
+        if (globalInitHooks.length === 0 && !taskInitHook) {
             return {};
         }
-        return this._tracer.startActiveSpan("config.init", async (span) => {
-            return await initFn(payload, { ctx, signal });
-        }, {
-            attributes: {
-                [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "function",
-            },
+        const result = await run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "init", async () => {
+            // Store global hook results in an array
+            const globalResults = [];
+            for (const hook of globalInitHooks) {
+                const [hookError, result] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("init()", async (span) => {
+                    const result = await hook.fn({ payload, ctx, signal, task: this.task.id });
+                    if (result && typeof result === "object" && !Array.isArray(result)) {
+                        span.setAttributes((0, index_js_1.flattenAttributes)(result));
+                        return result;
+                    }
+                    return {};
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-init",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes(hook.name),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+                if (result && typeof result === "object" && !Array.isArray(result)) {
+                    globalResults.push(result);
+                }
+            }
+            // Merge all global results into a single object
+            const mergedGlobalResults = Object.assign({}, ...globalResults);
+            if (taskInitHook) {
+                const [hookError, taskResult] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("init()", async (span) => {
+                    const result = await taskInitHook({ payload, ctx, signal, task: this.task.id });
+                    if (result && typeof result === "object" && !Array.isArray(result)) {
+                        span.setAttributes((0, index_js_1.flattenAttributes)(result));
+                        return result;
+                    }
+                    return {};
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-init",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes("task"),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+                // Only merge if taskResult is an object
+                if (taskResult && typeof taskResult === "object" && !Array.isArray(taskResult)) {
+                    return { ...mergedGlobalResults, ...taskResult };
+                }
+                // If taskResult isn't an object, return global results
+                return mergedGlobalResults;
+            }
+            return mergedGlobalResults;
         });
+        if (result && typeof result === "object" && !Array.isArray(result)) {
+            return result;
+        }
+        return;
     }
     async #callOnSuccessFunctions(payload, output, ctx, initOutput, signal) {
-        await this.#callOnSuccessFunction(this.task.fns.onSuccess, "task.onSuccess", payload, output, ctx, initOutput, signal);
-        await this.#callOnSuccessFunction(this._importedConfig?.onSuccess, "config.onSuccess", payload, output, ctx, initOutput, signal);
-    }
-    async #callOnSuccessFunction(onSuccessFn, name, payload, output, ctx, initOutput, signal) {
-        if (!onSuccessFn) {
+        const globalSuccessHooks = index_js_1.lifecycleHooks.getGlobalSuccessHooks();
+        const taskSuccessHook = index_js_1.lifecycleHooks.getTaskSuccessHook(this.task.id);
+        if (globalSuccessHooks.length === 0 && !taskSuccessHook) {
             return;
         }
-        try {
-            await this._tracer.startActiveSpan(name, async (span) => {
-                return await onSuccessFn(payload, output, { ctx, init: initOutput, signal });
-            }, {
-                attributes: {
-                    [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "function",
-                },
-            });
-        }
-        catch {
-            // Ignore errors from onSuccess functions
-        }
+        return await run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "success", async () => {
+            for (const hook of globalSuccessHooks) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onSuccess()", async (span) => {
+                    await hook.fn({
+                        payload,
+                        output,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onSuccess",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes(hook.name),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
+            if (taskSuccessHook) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onSuccess()", async (span) => {
+                    await taskSuccessHook({
+                        payload,
+                        output,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onSuccess",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes("task"),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
+        });
     }
     async #callOnFailureFunctions(payload, error, ctx, initOutput, signal) {
-        await this.#callOnFailureFunction(this.task.fns.onFailure, "task.onFailure", payload, error, ctx, initOutput, signal);
-        await this.#callOnFailureFunction(this._importedConfig?.onFailure, "config.onFailure", payload, error, ctx, initOutput, signal);
-    }
-    async #callOnFailureFunction(onFailureFn, name, payload, error, ctx, initOutput, signal) {
-        if (!onFailureFn) {
+        const globalFailureHooks = index_js_1.lifecycleHooks.getGlobalFailureHooks();
+        const taskFailureHook = index_js_1.lifecycleHooks.getTaskFailureHook(this.task.id);
+        if (globalFailureHooks.length === 0 && !taskFailureHook) {
             return;
         }
-        try {
-            return await this._tracer.startActiveSpan(name, async (span) => {
-                return await onFailureFn(payload, error, { ctx, init: initOutput, signal });
-            }, {
-                attributes: {
-                    [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "function",
-                },
-            });
-        }
-        catch (e) {
-            // Ignore errors from onFailure functions
-        }
+        return await run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "failure", async () => {
+            for (const hook of globalFailureHooks) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onFailure()", async (span) => {
+                    await hook.fn({
+                        payload,
+                        error,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onFailure",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes(hook.name),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
+            if (taskFailureHook) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onFailure()", async (span) => {
+                    await taskFailureHook({
+                        payload,
+                        error,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onFailure",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes("task"),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
+        });
     }
     async #parsePayload(payload) {
         if (!this.task.fns.parsePayload) {
             return payload;
         }
-        try {
-            return await this.task.fns.parsePayload(payload);
-        }
-        catch (e) {
-            throw new errors_js_1.TaskPayloadParsedError(e);
+        const [parseError, result] = await (0, tryCatch_js_1.tryCatch)(this.task.fns.parsePayload(payload));
+        if (parseError) {
+            throw new errors_js_1.TaskPayloadParsedError(parseError);
         }
+        return result;
     }
-    async #callOnStartFunctions(payload, ctx, signal) {
-        await this.#callOnStartFunction(this._importedConfig?.onStart, "config.onStart", payload, ctx, {}, signal);
-        await this.#callOnStartFunction(this.task.fns.onStart, "task.onStart", payload, ctx, {}, signal);
-    }
-    async #callOnStartFunction(onStartFn, name, payload, ctx, initOutput, signal) {
-        if (!onStartFn) {
+    async #callOnStartFunctions(payload, ctx, initOutput, signal) {
+        const globalStartHooks = index_js_1.lifecycleHooks.getGlobalStartHooks();
+        const taskStartHook = index_js_1.lifecycleHooks.getTaskStartHook(this.task.id);
+        if (globalStartHooks.length === 0 && !taskStartHook) {
             return;
         }
-        try {
-            await this._tracer.startActiveSpan(name, async (span) => {
-                return await onStartFn(payload, { ctx, signal });
-            }, {
-                attributes: {
-                    [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "function",
-                },
-            });
-        }
-        catch {
-            // Ignore errors from onStart functions
-        }
+        return await run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "start", async () => {
+            for (const hook of globalStartHooks) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onStart()", async (span) => {
+                    await hook.fn({ payload, ctx, signal, task: this.task.id, init: initOutput });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onStart",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes(hook.name),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
+            if (taskStartHook) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onStart()", async (span) => {
+                    await taskStartHook({
+                        payload,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onStart",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes("task"),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
+        });
+    }
+    async #cleanupAndWaitUntil(payload, ctx, initOutput, signal) {
+        await this.#callCleanupFunctions(payload, ctx, initOutput, signal);
+        await this.#blockForWaitUntil();
     }
-    async #callTaskCleanup(payload, ctx, init, signal) {
-        const cleanupFn = this.task.fns.cleanup;
-        if (!cleanupFn) {
+    async #callCleanupFunctions(payload, ctx, initOutput, signal) {
+        const globalCleanupHooks = index_js_1.lifecycleHooks.getGlobalCleanupHooks();
+        const taskCleanupHook = index_js_1.lifecycleHooks.getTaskCleanupHook(this.task.id);
+        if (globalCleanupHooks.length === 0 && !taskCleanupHook) {
             return;
         }
-        return this._tracer.startActiveSpan("cleanup", async (span) => {
-            return await cleanupFn(payload, { ctx, init, signal });
+        return await run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "cleanup", async () => {
+            for (const hook of globalCleanupHooks) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("cleanup()", async (span) => {
+                    await hook.fn({
+                        payload,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-cleanup",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes(hook.name),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
+            if (taskCleanupHook) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("cleanup()", async (span) => {
+                    await taskCleanupHook({
+                        payload,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-cleanup",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes("task"),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
+            }
         });
     }
     async #blockForWaitUntil() {
@@ -290,103 +592,212 @@ class TaskExecutor {
             return await index_js_1.waitUntil.blockUntilSettled(60_000);
         }, {
             attributes: {
-                [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "clock",
+                [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "tabler-clock",
+                [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
             },
         });
     }
     async #handleError(execution, error, payload, ctx, init, signal) {
-        const retriesConfig = this._importedConfig?.retries;
+        const retriesConfig = this._retries;
         const retry = this.task.retry ?? retriesConfig?.default;
-        if (!retry) {
-            return { status: "noop" };
+        // Early exit conditions that prevent retrying
+        if ((0, errors_js_1.isInternalError)(error) && error.skipRetrying) {
+            return { status: "skipped", error };
         }
         if (error instanceof Error &&
             (error.name === "AbortTaskRunError" || error.name === "TaskPayloadParsedError")) {
             return { status: "skipped" };
         }
-        if ((0, errors_js_1.isInternalError)(error) && error.skipRetrying) {
-            return { status: "skipped", error };
-        }
-        if (execution.run.maxAttempts) {
-            retry.maxAttempts = Math.max(execution.run.maxAttempts, 1);
-        }
-        let delay = (0, retries_js_1.calculateNextRetryDelay)(retry, execution.attempt.number);
-        if (delay &&
-            error instanceof Error &&
-            error.name === "TriggerApiError" &&
-            error.status === 429) {
-            const rateLimitError = error;
-            delay = rateLimitError.millisecondsUntilReset;
+        // Calculate default retry delay if retry config exists
+        let defaultDelay;
+        if (retry) {
+            if (execution.run.maxAttempts) {
+                retry.maxAttempts = Math.max(execution.run.maxAttempts, 1);
+            }
+            defaultDelay = (0, retries_js_1.calculateNextRetryDelay)(retry, execution.attempt.number);
+            // Handle rate limit errors
+            if (defaultDelay &&
+                error instanceof Error &&
+                error.name === "TriggerApiError" &&
+                error.status === 429) {
+                const rateLimitError = error;
+                defaultDelay = rateLimitError.millisecondsUntilReset;
+            }
         }
+        const defaultRetryResult = typeof defaultDelay === "undefined"
+            ? { status: "noop" }
+            : {
+                status: "retry",
+                retry: { timestamp: Date.now() + defaultDelay, delay: defaultDelay },
+            };
+        // Check if retries are enabled in dev environment
         if (execution.environment.type === "DEVELOPMENT" &&
             typeof retriesConfig?.enabledInDev === "boolean" &&
             !retriesConfig.enabledInDev) {
             return { status: "skipped" };
         }
-        return this._tracer.startActiveSpan("handleError()", async (span) => {
-            const handleErrorResult = this.task.fns.handleError
-                ? await this.task.fns.handleError(payload, error, {
+        const taskCatchErrorHook = index_js_1.lifecycleHooks.getTaskCatchErrorHook(this.task.id);
+        const globalCatchErrorHooks = index_js_1.lifecycleHooks.getGlobalCatchErrorHooks();
+        if (globalCatchErrorHooks.length === 0 && !taskCatchErrorHook) {
+            return defaultRetryResult;
+        }
+        return this._tracer.startActiveSpan("catchError", async (span) => {
+            // Try task-specific catch error hook first
+            if (taskCatchErrorHook) {
+                const result = await taskCatchErrorHook({
+                    payload,
+                    error,
                     ctx,
                     init,
                     retry,
-                    retryDelayInMs: delay,
-                    retryAt: delay ? new Date(Date.now() + delay) : undefined,
+                    retryDelayInMs: defaultDelay,
+                    retryAt: defaultDelay ? new Date(Date.now() + defaultDelay) : undefined,
                     signal,
-                })
-                : this._importedConfig
-                    ? await this._handleErrorFn?.(payload, error, {
-                        ctx,
-                        init,
-                        retry,
-                        retryDelayInMs: delay,
-                        retryAt: delay ? new Date(Date.now() + delay) : undefined,
-                        signal,
-                    })
-                    : undefined;
-            // If handleErrorResult
-            if (!handleErrorResult) {
-                return typeof delay === "undefined"
-                    ? { status: "noop" }
-                    : { status: "retry", retry: { timestamp: Date.now() + delay, delay } };
+                    task: this.task.id,
+                });
+                if (result) {
+                    return this.#processHandleErrorResult(result, execution.attempt.number, defaultDelay);
+                }
             }
-            if (handleErrorResult.skipRetrying) {
-                return { status: "skipped", error: handleErrorResult.error };
+            // Try global catch error hooks in order
+            for (const hook of globalCatchErrorHooks) {
+                const result = await hook.fn({
+                    payload,
+                    error,
+                    ctx,
+                    init,
+                    retry,
+                    retryDelayInMs: defaultDelay,
+                    retryAt: defaultDelay ? new Date(Date.now() + defaultDelay) : undefined,
+                    signal,
+                    task: this.task.id,
+                });
+                if (result) {
+                    return this.#processHandleErrorResult(result, execution.attempt.number, defaultDelay);
+                }
             }
-            if (typeof handleErrorResult.retryAt !== "undefined") {
-                return {
+            // If no hooks handled the error, use default retry behavior
+            return defaultRetryResult;
+        }, {
+            attributes: {
+                [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-catchError",
+                [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+            },
+        });
+    }
+    // Helper method to process handle error results
+    #processHandleErrorResult(result, attemptNumber, defaultDelay) {
+        if (result.skipRetrying) {
+            return { status: "skipped", error: result.error };
+        }
+        if (typeof result.retryAt !== "undefined") {
+            return {
+                status: "retry",
+                retry: {
+                    timestamp: result.retryAt.getTime(),
+                    delay: result.retryAt.getTime() - Date.now(),
+                },
+                error: result.error,
+            };
+        }
+        if (typeof result.retryDelayInMs === "number") {
+            return {
+                status: "retry",
+                retry: {
+                    timestamp: Date.now() + result.retryDelayInMs,
+                    delay: result.retryDelayInMs,
+                },
+                error: result.error,
+            };
+        }
+        if (result.retry && typeof result.retry === "object") {
+            const delay = (0, retries_js_1.calculateNextRetryDelay)(result.retry, attemptNumber);
+            return typeof delay === "undefined"
+                ? { status: "noop", error: result.error }
+                : {
                     status: "retry",
-                    retry: {
-                        timestamp: handleErrorResult.retryAt.getTime(),
-                        delay: handleErrorResult.retryAt.getTime() - Date.now(),
-                    },
-                    error: handleErrorResult.error,
+                    retry: { timestamp: Date.now() + delay, delay },
+                    error: result.error,
                 };
-            }
-            if (typeof handleErrorResult.retryDelayInMs === "number") {
-                return {
-                    status: "retry",
-                    retry: {
-                        timestamp: Date.now() + handleErrorResult.retryDelayInMs,
-                        delay: handleErrorResult.retryDelayInMs,
+        }
+        return { status: "noop", error: result.error };
+    }
+    async #callOnCompleteFunctions(payload, result, ctx, initOutput, signal) {
+        const globalCompleteHooks = index_js_1.lifecycleHooks.getGlobalCompleteHooks();
+        const taskCompleteHook = index_js_1.lifecycleHooks.getTaskCompleteHook(this.task.id);
+        if (globalCompleteHooks.length === 0 && !taskCompleteHook) {
+            return;
+        }
+        return await run_timeline_metrics_api_js_1.runTimelineMetrics.measureMetric("trigger.dev/execution", "complete", async () => {
+            for (const hook of globalCompleteHooks) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onComplete()", async (span) => {
+                    await hook.fn({
+                        payload,
+                        result,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onComplete",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes(hook.name),
                     },
-                    error: handleErrorResult.error,
-                };
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
             }
-            if (handleErrorResult.retry && typeof handleErrorResult.retry === "object") {
-                const delay = (0, retries_js_1.calculateNextRetryDelay)(handleErrorResult.retry, execution.attempt.number);
-                return typeof delay === "undefined"
-                    ? { status: "noop", error: handleErrorResult.error }
-                    : {
-                        status: "retry",
-                        retry: { timestamp: Date.now() + delay, delay },
-                        error: handleErrorResult.error,
-                    };
+            if (taskCompleteHook) {
+                const [hookError] = await (0, tryCatch_js_1.tryCatch)(this._tracer.startActiveSpan("onComplete()", async (span) => {
+                    await taskCompleteHook({
+                        payload,
+                        result,
+                        ctx,
+                        signal,
+                        task: this.task.id,
+                        init: initOutput,
+                    });
+                }, {
+                    attributes: {
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "task-hook-onComplete",
+                        [semanticInternalAttributes_js_1.SemanticInternalAttributes.COLLAPSED]: true,
+                        ...this.#lifecycleHookAccessoryAttributes("task"),
+                    },
+                }));
+                if (hookError) {
+                    throw hookError;
+                }
             }
-            return { status: "noop", error: handleErrorResult.error };
-        }, {
-            attributes: {
-                [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: "exclamation-circle",
+        });
+    }
+    #internalErrorResult(execution, code, error) {
+        return {
+            ok: false,
+            id: execution.run.id,
+            error: {
+                type: "INTERNAL_ERROR",
+                code,
+                message: error instanceof Error
+                    ? `${error.name}: ${error.message}`
+                    : typeof error === "string"
+                        ? error
+                        : undefined,
+                stackTrace: error instanceof Error ? error.stack : undefined,
             },
+        };
+    }
+    #lifecycleHookAccessoryAttributes(name) {
+        return (0, index_js_1.accessoryAttributes)({
+            items: [
+                {
+                    text: name ?? "global",
+                    variant: "normal",
+                },
+            ],
+            style: "codepath",
         });
     }
 }