@trigger.dev/core 0.0.0-python-preview-20250226140121 → 0.0.0-rc-4-8-0-20261021151928

package/dist/commonjs/v3/errors.js

@@ -1,15 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GracefulExitTimeoutError = exports.SigKillTimeoutProcessError = exports.CancelledProcessError = exports.CleanupProcessError = exports.UnexpectedExitError = exports.TaskIndexingImportError = exports.TaskMetadataParseError = exports.UncaughtExceptionError = exports.TaskPayloadParsedError = exports.OutOfMemoryError = exports.AbortTaskRunError = exports.InternalError = void 0;
+exports.MaxDurationExceededError = exports.ChatChunkTooLargeError = exports.GracefulExitTimeoutError = exports.SigKillTimeoutProcessError = exports.CancelledProcessError = exports.SuspendedProcessError = exports.CleanupProcessError = exports.UnexpectedExitError = exports.WebhookFilterError = exports.WebhookEndpointNotFoundError = exports.WebhookWaiterLimitError = exports.WebhookWaiterCancelledError = exports.WebhookIndexingError = exports.DuplicateTaskIdsError = exports.TaskIndexingImportError = exports.TaskMetadataParseError = exports.UncaughtExceptionError = exports.CompleteTaskWithOutput = exports.TaskPayloadParsedError = exports.OutOfMemoryError = exports.AbortTaskRunError = exports.InternalError = void 0;
 exports.isInternalError = isInternalError;
 exports.isManualOutOfMemoryError = isManualOutOfMemoryError;
+exports.isOOMRunError = isOOMRunError;
+exports.isCompleteTaskWithOutput = isCompleteTaskWithOutput;
+exports.truncateStack = truncateStack;
+exports.truncateMessage = truncateMessage;
+exports.createErrorFromCauses = createErrorFromCauses;
+exports.formatErrorCauses = formatErrorCauses;
 exports.parseError = parseError;
 exports.createErrorTaskError = createErrorTaskError;
 exports.createJsonErrorObject = createJsonErrorObject;
 exports.sanitizeError = sanitizeError;
 exports.shouldRetryError = shouldRetryError;
+exports.shouldLookupRetrySettings = shouldLookupRetrySettings;
 exports.correctErrorStackTrace = correctErrorStackTrace;
 exports.groupTaskMetadataIssuesByTask = groupTaskMetadataIssuesByTask;
+exports.isChatChunkTooLargeError = isChatChunkTooLargeError;
 exports.taskRunErrorEnhancer = taskRunErrorEnhancer;
 exports.exceptionEventEnhancer = exceptionEventEnhancer;
 exports.internalErrorFromUnexpectedExit = internalErrorFromUnexpectedExit;
@@ -70,6 +78,47 @@ function isManualOutOfMemoryError(error) {
     }
     return false;
 }
+function isOOMRunError(error) {
+    if (error.type === "INTERNAL_ERROR") {
+        if (error.code === "TASK_PROCESS_OOM_KILLED" ||
+            error.code === "TASK_PROCESS_MAYBE_OOM_KILLED") {
+            return true;
+        }
+        // For the purposes of retrying on a larger machine, we're going to treat this is an OOM error.
+        // This is what they look like if we're executing using k8s. They then get corrected later, but it's too late.
+        // {"code": "TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE", "type": "INTERNAL_ERROR", "message": "Process exited with code -1 after signal SIGKILL."}
+        if (error.code === "TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE" &&
+            error.message &&
+            error.message.includes("-1")) {
+            if (error.message.includes("SIGKILL")) {
+                return true;
+            }
+            if (error.message.includes("SIGABRT") && error.stackTrace) {
+                const oomIndicators = [
+                    "JavaScript heap out of memory",
+                    "Reached heap limit",
+                    "FATAL ERROR: Reached heap limit Allocation failed",
+                ];
+                if (oomIndicators.some((indicator) => error.stackTrace.includes(indicator))) {
+                    return true;
+                }
+            }
+        }
+    }
+    if (error.type === "BUILT_IN_ERROR") {
+        // ffmpeg also does weird stuff
+        // { "name": "Error", "type": "BUILT_IN_ERROR", "message": "ffmpeg was killed with signal SIGKILL" }
+        if (error.message && error.message.includes("ffmpeg was killed with signal SIGKILL")) {
+            return true;
+        }
+    }
+    // Special `OutOfMemoryError` for doing a manual OOM kill.
+    // Useful if a native library does an OOM but doesn't actually crash the run and you want to manually
+    if (isManualOutOfMemoryError(error)) {
+        return true;
+    }
+    return false;
+}
 class TaskPayloadParsedError extends Error {
     cause;
     constructor(cause) {
@@ -80,21 +129,187 @@ class TaskPayloadParsedError extends Error {
     }
 }
 exports.TaskPayloadParsedError = TaskPayloadParsedError;
+class CompleteTaskWithOutput extends Error {
+    output;
+    constructor(output) {
+        super("Complete task with output");
+        this.name = "CompleteTaskWithOutput";
+        this.output = output;
+    }
+}
+exports.CompleteTaskWithOutput = CompleteTaskWithOutput;
+function isCompleteTaskWithOutput(error) {
+    return error instanceof Error && error.name === "CompleteTaskWithOutput";
+}
+const MAX_STACK_FRAMES = 50;
+const KEEP_TOP_FRAMES = 5;
+const MAX_STACK_LINE_LENGTH = 1024;
+const MAX_MESSAGE_LENGTH = 1_000;
+const MAX_ERROR_CAUSES = 5;
+/** Causes are supplementary, and there can be MAX_ERROR_CAUSES of them, so they get a
+ *  much tighter frame budget than the error that was actually thrown. */
+const MAX_CAUSE_STACK_FRAMES = 10;
+/** An error name is a class name in practice, so anything longer is junk that
+ *  would otherwise ride along untruncated, once per cause. */
+const MAX_ERROR_NAME_LENGTH = 256;
+function truncateName(name) {
+    if (!name)
+        return undefined;
+    return name.length > MAX_ERROR_NAME_LENGTH ? name.slice(0, MAX_ERROR_NAME_LENGTH) : name;
+}
+/** Truncate a stack trace to at most MAX_STACK_FRAMES frames, keeping
+ *  the top (closest to throw) and bottom (entry points) frames.
+ *  Individual lines (including message lines) are capped at MAX_STACK_LINE_LENGTH
+ *  to prevent OOM from huge error messages embedded in the stack. */
+function truncateStack(stack, maxFrames = MAX_STACK_FRAMES) {
+    if (!stack)
+        return "";
+    const lines = stack.split("\n");
+    // First line(s) before the first frame are the error message
+    const messageLines = [];
+    const frameLines = [];
+    for (const line of lines) {
+        const safe = line.length > MAX_STACK_LINE_LENGTH
+            ? line.slice(0, MAX_STACK_LINE_LENGTH) + "...[truncated]"
+            : line;
+        if (frameLines.length === 0 && !line.trimStart().startsWith("at ")) {
+            messageLines.push(safe);
+        }
+        else {
+            frameLines.push(safe);
+        }
+    }
+    if (frameLines.length <= maxFrames) {
+        return [...messageLines, ...frameLines].join("\n");
+    }
+    const keepTop = Math.min(KEEP_TOP_FRAMES, maxFrames);
+    const keepBottom = maxFrames - keepTop;
+    const omitted = frameLines.length - maxFrames;
+    return [
+        ...messageLines,
+        ...frameLines.slice(0, keepTop),
+        `    ... ${omitted} frames omitted ...`,
+        ...(keepBottom > 0 ? frameLines.slice(-keepBottom) : []),
+    ].join("\n");
+}
+function truncateMessage(message) {
+    if (!message)
+        return "";
+    return message.length > MAX_MESSAGE_LENGTH
+        ? message.slice(0, MAX_MESSAGE_LENGTH) + "...[truncated]"
+        : message;
+}
+/** Serialize one `cause` value. A cause is arbitrary user data, so every step here
+ *  can throw: `instanceof` and property reads run Proxy traps, and JSON.stringify
+ *  and String both throw on some values. Losing a cause is acceptable; throwing
+ *  would lose the whole error report. Returns undefined for a cause that carries
+ *  nothing worth rendering. */
+function serializeErrorCause(cause) {
+    try {
+        if (cause instanceof Error) {
+            const name = truncateName(cause.name);
+            const message = truncateMessage(cause.message);
+            const stackTrace = truncateStack(cause.stack, MAX_CAUSE_STACK_FRAMES) || undefined;
+            return name || message || stackTrace ? { name, message, stackTrace } : undefined;
+        }
+        if (typeof cause === "string") {
+            return cause ? { message: truncateMessage(cause) } : undefined;
+        }
+        try {
+            const json = JSON.stringify(cause);
+            if (json !== undefined) {
+                return { message: truncateMessage(json) };
+            }
+        }
+        catch (_e) {
+            /** fall through to the coercion attempt */
+        }
+        return { message: truncateMessage(String(cause)) };
+    }
+    catch (_e) {
+        return { message: `[unserializable ${typeof cause} cause]` };
+    }
+}
+/** Reading `.cause` runs `instanceof` and a property get, either of which can throw
+ *  on a hostile or revoked Proxy. Stop the walk instead of aborting the report. */
+function readErrorCause(value) {
+    try {
+        return value instanceof Error ? value.cause : undefined;
+    }
+    catch (_e) {
+        return undefined;
+    }
+}
+/** Flatten an error's `cause` chain, outermost first. Bounded by MAX_ERROR_CAUSES
+ *  and guarded against cycles, since a cause chain is attacker- (or accident-) shaped. */
+function extractErrorCauses(error) {
+    const causes = [];
+    const seen = new Set([error]);
+    let current = readErrorCause(error);
+    /** Every link visited counts against the cap, including ones that serialize to
+     *  nothing, so a chain of empty causes cannot extend the walk. */
+    for (let i = 0; i < MAX_ERROR_CAUSES && current !== undefined && current !== null; i++) {
+        if (typeof current === "object") {
+            if (seen.has(current)) {
+                break;
+            }
+            seen.add(current);
+        }
+        const cause = serializeErrorCause(current);
+        if (cause) {
+            causes.push(cause);
+        }
+        current = readErrorCause(current);
+    }
+    return causes.length > 0 ? causes : undefined;
+}
+/** Rebuild a native `cause` chain from the flattened form, innermost first. */
+function createErrorFromCauses(causes) {
+    let current;
+    for (let i = causes.length - 1; i >= 0; i--) {
+        const cause = causes[i];
+        const error = new Error(cause.message, current ? { cause: current } : undefined);
+        if (cause.name) {
+            error.name = cause.name;
+        }
+        error.stack = cause.stackTrace || [cause.name, cause.message].filter(Boolean).join(": ");
+        current = error;
+    }
+    return current;
+}
+/** Render a flattened cause chain the way Node prints one. `stackTrace` opts into the
+ *  full frames; without it each cause is a single "Caused by:" line. */
+function formatErrorCauses(causes, options) {
+    if (!causes || causes.length === 0) {
+        return "";
+    }
+    return causes
+        .map((cause) => {
+        if (options?.stackTrace && cause.stackTrace) {
+            return `\n\nCaused by: ${cause.stackTrace}`;
+        }
+        const label = [cause.name, cause.message].filter(Boolean).join(": ");
+        return label ? `\nCaused by: ${label}` : "";
+    })
+        .join("");
+}
 function parseError(error) {
     if (isInternalError(error)) {
         return {
             type: "INTERNAL_ERROR",
             code: error.code,
-            message: error.message,
-            stackTrace: error.stack ?? "",
+            message: truncateMessage(error.message),
+            stackTrace: truncateStack(error.stack),
         };
     }
     if (error instanceof Error) {
+        const causes = extractErrorCauses(error);
         return {
             type: "BUILT_IN_ERROR",
             name: error.name,
-            message: error.message,
-            stackTrace: error.stack ?? "",
+            message: truncateMessage(error.message),
+            stackTrace: truncateStack(error.stack),
+            ...(causes ? { causes } : {}),
         };
     }
     if (typeof error === "string") {
@@ -109,7 +324,7 @@ function parseError(error) {
             raw: JSON.stringify(error),
         };
     }
-    catch (e) {
+    catch (_e) {
         return {
             type: "CUSTOM_ERROR",
             raw: String(error),
@@ -119,7 +334,8 @@ function parseError(error) {
 function createErrorTaskError(error) {
     switch (error.type) {
         case "BUILT_IN_ERROR": {
-            const e = new Error(error.message);
+            const cause = error.causes?.length ? createErrorFromCauses(error.causes) : undefined;
+            const e = new Error(error.message, cause ? { cause } : undefined);
             e.name = error.name;
             e.stack = error.stackTrace;
             return e;
@@ -146,6 +362,7 @@ function createJsonErrorObject(error) {
                 name: enhancedError.name,
                 message: enhancedError.message,
                 stackTrace: enhancedError.stackTrace,
+                ...(enhancedError.causes?.length ? { causes: enhancedError.causes } : {}),
             };
         }
         case "STRING_ERROR": {
@@ -165,35 +382,59 @@ function createJsonErrorObject(error) {
         }
     }
 }
-// Removes any null characters from the error message
+function sanitizeErrorCauses(causes) {
+    if (!causes || causes.length === 0) {
+        return undefined;
+    }
+    return causes.slice(0, MAX_ERROR_CAUSES).map((cause) => ({
+        name: truncateName(cause.name?.replace(/\0/g, "")),
+        message: truncateMessage(cause.message?.replace(/\0/g, "")),
+        stackTrace: cause.stackTrace
+            ? truncateStack(cause.stackTrace.replace(/\0/g, ""), MAX_CAUSE_STACK_FRAMES) || undefined
+            : undefined,
+    }));
+}
+// Removes null characters and truncates oversized fields to prevent OOM
 function sanitizeError(error) {
     switch (error.type) {
         case "BUILT_IN_ERROR": {
+            const causes = sanitizeErrorCauses(error.causes);
             return {
                 type: "BUILT_IN_ERROR",
-                message: error.message?.replace(/\0/g, ""),
+                message: truncateMessage(error.message?.replace(/\0/g, "")),
                 name: error.name?.replace(/\0/g, ""),
-                stackTrace: error.stackTrace?.replace(/\0/g, ""),
+                stackTrace: truncateStack(error.stackTrace?.replace(/\0/g, "")),
+                ...(causes ? { causes } : {}),
             };
         }
         case "STRING_ERROR": {
             return {
                 type: "STRING_ERROR",
-                raw: error.raw.replace(/\0/g, ""),
+                raw: truncateMessage(error.raw.replace(/\0/g, "")),
             };
         }
         case "CUSTOM_ERROR": {
+            // CUSTOM_ERROR.raw holds JSON.stringify(error) which is later parsed by
+            // JSON.parse in createErrorTaskError. Naive truncation would cut mid-token
+            // and produce invalid JSON — wrap the preview in a valid JSON envelope.
+            const clean = error.raw.replace(/\0/g, "");
+            const safeRaw = clean.length > MAX_MESSAGE_LENGTH
+                ? JSON.stringify({ truncated: true, preview: clean.slice(0, MAX_MESSAGE_LENGTH) })
+                : clean;
             return {
                 type: "CUSTOM_ERROR",
-                raw: error.raw.replace(/\0/g, ""),
+                raw: safeRaw,
             };
         }
         case "INTERNAL_ERROR": {
+            // message and stackTrace are optional for INTERNAL_ERROR — preserve
+            // `undefined` so the `error.message ?? "Internal error (CODE)"` fallback
+            // in createErrorTaskError still kicks in (empty string is not nullish).
             return {
                 type: "INTERNAL_ERROR",
                 code: error.code,
-                message: error.message?.replace(/\0/g, ""),
-                stackTrace: error.stackTrace?.replace(/\0/g, ""),
+                message: error.message != null ? truncateMessage(error.message.replace(/\0/g, "")) : undefined,
+                stackTrace: error.stackTrace != null ? truncateStack(error.stackTrace.replace(/\0/g, "")) : undefined,
             };
         }
     }
@@ -208,28 +449,42 @@ function shouldRetryError(error) {
                 case "CONFIGURED_INCORRECTLY":
                 case "TASK_ALREADY_RUNNING":
                 case "TASK_PROCESS_SIGKILL_TIMEOUT":
-                case "TASK_PROCESS_SIGSEGV":
                 case "TASK_PROCESS_OOM_KILLED":
                 case "TASK_PROCESS_MAYBE_OOM_KILLED":
                 case "TASK_RUN_CANCELLED":
                 case "MAX_DURATION_EXCEEDED":
                 case "DISK_SPACE_EXCEEDED":
-                case "TASK_RUN_HEARTBEAT_TIMEOUT":
                 case "OUTDATED_SDK_VERSION":
+                case "TASK_RUN_HEARTBEAT_TIMEOUT":
                 case "TASK_DID_CONCURRENT_WAIT":
                 case "RECURSIVE_WAIT_DEADLOCK":
+                // run engine errors
+                case "TASK_DEQUEUED_INVALID_STATE":
+                case "TASK_DEQUEUED_QUEUE_NOT_FOUND":
+                case "TASK_HAS_N0_EXECUTION_SNAPSHOT":
+                case "TASK_RUN_DEQUEUED_MAX_RETRIES":
+                case "BATCH_ITEM_COULD_NOT_TRIGGER":
+                case "PAYLOAD_TOO_LARGE":
+                case "UNSPECIFIED_ERROR":
                     return false;
+                //new heartbeat error
+                //todo
+                case "TASK_RUN_STALLED_EXECUTING":
+                case "TASK_RUN_STALLED_EXECUTING_WITH_WAITPOINTS":
                 case "GRACEFUL_EXIT_TIMEOUT":
                 case "HANDLE_ERROR_ERROR":
                 case "TASK_INPUT_ERROR":
                 case "TASK_OUTPUT_ERROR":
+                case "TASK_MIDDLEWARE_ERROR":
                 case "POD_EVICTED":
                 case "POD_UNKNOWN_ERROR":
                 case "TASK_EXECUTION_ABORTED":
                 case "TASK_EXECUTION_FAILED":
                 case "TASK_RUN_CRASHED":
+                case "TASK_RUN_UNCAUGHT_EXCEPTION":
                 case "TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE":
                 case "TASK_PROCESS_SIGTERM":
+                case "TASK_PROCESS_SIGSEGV":
                     return true;
                 default:
                     (0, utils_js_1.assertExhaustive)(error.code);
@@ -249,6 +504,34 @@ function shouldRetryError(error) {
         }
     }
 }
+function shouldLookupRetrySettings(error) {
+    switch (error.type) {
+        case "INTERNAL_ERROR": {
+            switch (error.code) {
+                case "TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE":
+                case "TASK_PROCESS_SIGTERM":
+                case "TASK_PROCESS_SIGSEGV":
+                case "TASK_RUN_UNCAUGHT_EXCEPTION":
+                case "TASK_MIDDLEWARE_ERROR":
+                    return true;
+                default:
+                    return false;
+            }
+        }
+        case "STRING_ERROR": {
+            return false;
+        }
+        case "BUILT_IN_ERROR": {
+            return false;
+        }
+        case "CUSTOM_ERROR": {
+            return false;
+        }
+        default: {
+            (0, utils_js_1.assertExhaustive)(error);
+        }
+    }
+}
 function correctErrorStackTrace(stackTrace, projectDir, options) {
     const [errorLine, ...traceLines] = stackTrace.split("\n");
     return [
@@ -348,6 +631,99 @@ class TaskIndexingImportError extends Error {
     }
 }
 exports.TaskIndexingImportError = TaskIndexingImportError;
+function formatDuplicateTaskIds(collisions) {
+    const lines = collisions.map(({ id, filePaths }) => {
+        const distinct = Array.from(new Set(filePaths));
+        if (distinct.length === 1) {
+            return `  - "${id}" found more than once in ${distinct[0]}`;
+        }
+        const last = distinct[distinct.length - 1];
+        const head = distinct.slice(0, -1).join(", ");
+        return `  - "${id}" found in ${head} and ${last}`;
+    });
+    return [
+        "Duplicate task ids detected:",
+        "",
+        ...lines,
+        "",
+        "Task ids must be unique across your project (including scheduled tasks). Please rename one of them.",
+    ].join("\n");
+}
+class DuplicateTaskIdsError extends Error {
+    collisions;
+    constructor(collisions) {
+        super(formatDuplicateTaskIds(collisions));
+        this.collisions = collisions;
+        this.name = "DuplicateTaskIdsError";
+    }
+}
+exports.DuplicateTaskIdsError = DuplicateTaskIdsError;
+function formatWebhookIndexingErrors(collisions, problems) {
+    const lines = collisions.map(({ id, filePaths }) => {
+        const distinct = Array.from(new Set(filePaths));
+        if (distinct.length === 1) {
+            return `  - endpoint "${id}" defined more than once in ${distinct[0]}`;
+        }
+        const last = distinct[distinct.length - 1];
+        const head = distinct.slice(0, -1).join(", ");
+        return `  - endpoint "${id}" defined in ${head} and ${last}`;
+    });
+    return [
+        "Webhook endpoints could not be indexed:",
+        "",
+        ...lines,
+        ...problems.map((problem) => `  - ${problem}`),
+    ].join("\n");
+}
+/**
+ * Webhook declarations the indexer refuses: an endpoint id defined twice, a subscriber whose
+ * endpoint isn't defined, or two subscribers with the same id on one endpoint.
+ */
+class WebhookIndexingError extends Error {
+    collisions;
+    problems;
+    constructor(collisions, problems = []) {
+        super(formatWebhookIndexingErrors(collisions, problems));
+        this.collisions = collisions;
+        this.problems = problems;
+        this.name = "WebhookIndexingError";
+    }
+}
+exports.WebhookIndexingError = WebhookIndexingError;
+/** A webhook waiter was cancelled before a delivery matched it. */
+class WebhookWaiterCancelledError extends Error {
+    constructor(message = "The webhook waiter was cancelled") {
+        super(message);
+        this.name = "WebhookWaiterCancelledError";
+    }
+}
+exports.WebhookWaiterCancelledError = WebhookWaiterCancelledError;
+/** `webhooks.waiter.create` hit a waiter limit. Nothing was created. */
+class WebhookWaiterLimitError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.reason = reason;
+        this.name = "WebhookWaiterLimitError";
+    }
+}
+exports.WebhookWaiterLimitError = WebhookWaiterLimitError;
+/** The endpoint isn't in this environment's current deployment. */
+class WebhookEndpointNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebhookEndpointNotFoundError";
+    }
+}
+exports.WebhookEndpointNotFoundError = WebhookEndpointNotFoundError;
+/** A waiter's filter didn't compile on the server. */
+class WebhookFilterError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WebhookFilterError";
+    }
+}
+exports.WebhookFilterError = WebhookFilterError;
 class UnexpectedExitError extends Error {
     code;
     signal;
@@ -368,6 +744,13 @@ class CleanupProcessError extends Error {
     }
 }
 exports.CleanupProcessError = CleanupProcessError;
+class SuspendedProcessError extends Error {
+    constructor() {
+        super("Suspended");
+        this.name = "SuspendedProcessError";
+    }
+}
+exports.SuspendedProcessError = SuspendedProcessError;
 class CancelledProcessError extends Error {
     constructor() {
         super("Cancelled");
@@ -389,16 +772,46 @@ class GracefulExitTimeoutError extends Error {
     }
 }
 exports.GracefulExitTimeoutError = GracefulExitTimeoutError;
+class ChatChunkTooLargeError extends Error {
+    chunkSize;
+    maxSize;
+    chunkType;
+    constructor(chunkSize, maxSize, chunkType) {
+        super(`chat.agent chunk${chunkType ? ` of type "${chunkType}"` : ""} is ${chunkSize} bytes, ` +
+            `over the realtime stream's per-record cap of ${maxSize} bytes. ` +
+            `For oversized payloads (e.g. large tool outputs), write the value to your own store and ` +
+            `emit only an id/url through the chat stream — see https://trigger.dev/docs/ai-chat/patterns/large-payloads.`);
+        this.chunkSize = chunkSize;
+        this.maxSize = maxSize;
+        this.chunkType = chunkType;
+        this.name = "ChatChunkTooLargeError";
+    }
+}
+exports.ChatChunkTooLargeError = ChatChunkTooLargeError;
+function isChatChunkTooLargeError(error) {
+    return error instanceof Error && error.name === "ChatChunkTooLargeError";
+}
+class MaxDurationExceededError extends Error {
+    maxDurationInSeconds;
+    elapsedTimeInSeconds;
+    constructor(maxDurationInSeconds, elapsedTimeInSeconds) {
+        super(`Run exceeded maximum compute time (maxDuration) of ${maxDurationInSeconds} seconds`);
+        this.maxDurationInSeconds = maxDurationInSeconds;
+        this.elapsedTimeInSeconds = elapsedTimeInSeconds;
+        this.name = "MaxDurationExceededError";
+    }
+}
+exports.MaxDurationExceededError = MaxDurationExceededError;
 const prettyInternalErrors = {
     TASK_PROCESS_OOM_KILLED: {
-        message: "Your task ran out of memory. Try increasing the machine specs. If this doesn't fix it there might be a memory leak.",
+        message: "Your run was terminated due to exceeding the machine's memory limit. Try increasing the machine preset in your task options or replay using a larger machine.",
         link: {
             name: "Machines",
             href: links_js_1.links.docs.machines.home,
         },
     },
     TASK_PROCESS_MAYBE_OOM_KILLED: {
-        message: "We think your task ran out of memory, but we can't be certain. If this keeps happening, try increasing the machine specs.",
+        message: "Your run was terminated due to exceeding the machine's memory limit. Try increasing the machine preset in your task options or replay using a larger machine.",
         link: {
             name: "Machines",
             href: links_js_1.links.docs.machines.home,
@@ -441,6 +854,24 @@ const prettyInternalErrors = {
             href: links_js_1.links.docs.concurrency.recursiveDeadlock,
         },
     },
+    TASK_RUN_STALLED_EXECUTING: {
+        link: {
+            name: "Read our troubleshooting guide",
+            href: links_js_1.links.docs.troubleshooting.stalledExecution,
+        },
+    },
+    // Link only — we deliberately do NOT set `message`, so the original
+    // error message (e.g. "read ECONNRESET") is preserved in the dashboard.
+    // Common cause: an EventEmitter (node-redis, pg, etc.) emitted "error"
+    // with no listener attached, which Node escalates to uncaughtException.
+    // The docs page explains how to attach .on("error") listeners and how
+    // unhandled rejections route through the same path.
+    TASK_RUN_UNCAUGHT_EXCEPTION: {
+        link: {
+            name: "Read our troubleshooting guide",
+            href: links_js_1.links.docs.troubleshooting.uncaughtException,
+        },
+    },
 };
 const getPrettyTaskRunError = (code) => {
     return {
@@ -469,6 +900,9 @@ const findSignalInMessage = (message, truncateLength = 100) => {
     else if (trunc.includes("SIGKILL")) {
         return "SIGKILL";
     }
+    else if (trunc.includes("SIGABRT")) {
+        return "SIGABRT";
+    }
     else {
         return;
     }
@@ -492,6 +926,10 @@ function taskRunErrorEnhancer(error) {
                             return {
                                 ...getPrettyTaskRunError("TASK_PROCESS_MAYBE_OOM_KILLED"),
                             };
+                        case "SIGABRT":
+                            return {
+                                ...getPrettyTaskRunError("TASK_PROCESS_MAYBE_OOM_KILLED"),
+                            };
                         default:
                             return {
                                 ...getPrettyTaskRunError("TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE"),
@@ -513,6 +951,21 @@ function taskRunErrorEnhancer(error) {
                     ...getPrettyTaskRunError("TASK_PROCESS_OOM_KILLED"),
                 };
             }
+            if (error.name === "TriggerApiError") {
+                if (error.message.startsWith("Deadlock detected:")) {
+                    return {
+                        type: "BUILT_IN_ERROR",
+                        name: "Concurrency Deadlock Error",
+                        message: error.message,
+                        stackTrace: "",
+                        ...(error.causes?.length ? { causes: error.causes } : {}),
+                        link: {
+                            name: "Read the docs",
+                            href: links_js_1.links.docs.concurrency.deadlock,
+                        },
+                    };
+                }
+            }
             break;
         }
         case "STRING_ERROR": {
@@ -537,6 +990,10 @@ function taskRunErrorEnhancer(error) {
                         return {
                             ...getPrettyTaskRunError("TASK_PROCESS_MAYBE_OOM_KILLED"),
                         };
+                    case "SIGABRT":
+                        return {
+                            ...getPrettyTaskRunError("TASK_PROCESS_MAYBE_OOM_KILLED"),
+                        };
                     default: {
                         return {
                             ...getPrettyTaskRunError("TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE"),
@@ -584,6 +1041,11 @@ function exceptionEventEnhancer(exception) {
                             ...exception,
                             ...getPrettyExceptionEvent("TASK_PROCESS_MAYBE_OOM_KILLED"),
                         };
+                    case "SIGABRT":
+                        return {
+                            ...exception,
+                            ...getPrettyExceptionEvent("TASK_PROCESS_MAYBE_OOM_KILLED"),
+                        };
                     default:
                         return exception;
                 }
@@ -770,6 +1232,8 @@ function createTaskMetadataFailedErrorStack(data) {
     const stack = [];
     const groupedIssues = groupTaskMetadataIssuesByTask(data.tasks, data.zodIssues);
     for (const key in groupedIssues) {
+        if (!Object.hasOwn(groupedIssues, key))
+            continue;
         const taskWithIssues = groupedIssues[key];
         if (!taskWithIssues) {
             continue;
@@ -804,7 +1268,7 @@ function taskRunErrorToString(error) {
             return `Internal error [${error.code}]${error.message ? `: ${error.message}` : ""}`;
         }
         case "BUILT_IN_ERROR": {
-            return `${error.name}: ${error.message}`;
+            return `${error.name}: ${error.message}${formatErrorCauses(error.causes)}`;
         }
         case "STRING_ERROR": {
             return error.raw;