@trigger.dev/core 3.0.12 → 3.1.0

package/dist/esm/v3/apiClient/runStream.js

@@ -0,0 +1,154 @@
+import { SubscribeRunRawShape } from "../schemas/api.js";
+import { conditionallyImportAndParsePacket, parsePacket, } from "../utils/ioSerialization.js";
+import { createAsyncIterableStream, zodShapeStream } from "./stream.js";
+export function runShapeStream(url, options) {
+    return new RunSubscription(url, options);
+}
+export class RunSubscription {
+    url;
+    options;
+    abortController;
+    unsubscribeShape;
+    stream;
+    packetCache = new Map();
+    constructor(url, options) {
+        this.url = url;
+        this.options = options;
+        this.abortController = new AbortController();
+        const source = new ReadableStream({
+            start: async (controller) => {
+                this.unsubscribeShape = await zodShapeStream(SubscribeRunRawShape, this.url, async (shape) => {
+                    controller.enqueue(shape);
+                    if (this.options?.closeOnComplete &&
+                        shape.completedAt &&
+                        !this.abortController.signal.aborted) {
+                        controller.close();
+                        this.abortController.abort();
+                    }
+                }, {
+                    signal: this.abortController.signal,
+                    fetchClient: this.options?.fetchClient,
+                    headers: this.options?.headers,
+                });
+            },
+            cancel: () => {
+                this.unsubscribe();
+            },
+        });
+        this.stream = createAsyncIterableStream(source, {
+            transform: async (chunk, controller) => {
+                const run = await this.transformRunShape(chunk);
+                controller.enqueue(run);
+            },
+        });
+    }
+    unsubscribe() {
+        if (!this.abortController.signal.aborted) {
+            this.abortController.abort();
+        }
+        this.unsubscribeShape?.();
+    }
+    [Symbol.asyncIterator]() {
+        return this.stream[Symbol.asyncIterator]();
+    }
+    getReader() {
+        return this.stream.getReader();
+    }
+    async transformRunShape(row) {
+        const payloadPacket = row.payloadType
+            ? { data: row.payload ?? undefined, dataType: row.payloadType }
+            : undefined;
+        const outputPacket = row.outputType
+            ? { data: row.output ?? undefined, dataType: row.outputType }
+            : undefined;
+        const [payload, output] = await Promise.all([
+            { packet: payloadPacket, key: "payload" },
+            { packet: outputPacket, key: "output" },
+        ].map(async ({ packet, key }) => {
+            if (!packet) {
+                return;
+            }
+            const cachedResult = this.packetCache.get(`${row.friendlyId}/${key}`);
+            if (typeof cachedResult !== "undefined") {
+                return cachedResult;
+            }
+            const result = await conditionallyImportAndParsePacket(packet);
+            this.packetCache.set(`${row.friendlyId}/${key}`, result);
+            return result;
+        }));
+        const metadata = row.metadata && row.metadataType
+            ? await parsePacket({ data: row.metadata, dataType: row.metadataType })
+            : undefined;
+        return {
+            id: row.friendlyId,
+            payload,
+            output,
+            createdAt: row.createdAt,
+            updatedAt: row.updatedAt,
+            taskIdentifier: row.taskIdentifier,
+            number: row.number,
+            status: apiStatusFromRunStatus(row.status),
+            durationMs: row.usageDurationMs,
+            costInCents: row.costInCents,
+            baseCostInCents: row.baseCostInCents,
+            tags: row.runTags ?? [],
+            idempotencyKey: row.idempotencyKey ?? undefined,
+            expiredAt: row.expiredAt ?? undefined,
+            finishedAt: row.completedAt ?? undefined,
+            startedAt: row.startedAt ?? undefined,
+            delayedUntil: row.delayUntil ?? undefined,
+            queuedAt: row.queuedAt ?? undefined,
+            error: row.error ?? undefined,
+            isTest: row.isTest,
+            metadata,
+        };
+    }
+}
+function apiStatusFromRunStatus(status) {
+    switch (status) {
+        case "DELAYED": {
+            return "DELAYED";
+        }
+        case "WAITING_FOR_DEPLOY": {
+            return "WAITING_FOR_DEPLOY";
+        }
+        case "PENDING": {
+            return "QUEUED";
+        }
+        case "PAUSED":
+        case "WAITING_TO_RESUME": {
+            return "FROZEN";
+        }
+        case "RETRYING_AFTER_FAILURE": {
+            return "REATTEMPTING";
+        }
+        case "EXECUTING": {
+            return "EXECUTING";
+        }
+        case "CANCELED": {
+            return "CANCELED";
+        }
+        case "COMPLETED_SUCCESSFULLY": {
+            return "COMPLETED";
+        }
+        case "SYSTEM_FAILURE": {
+            return "SYSTEM_FAILURE";
+        }
+        case "INTERRUPTED": {
+            return "INTERRUPTED";
+        }
+        case "CRASHED": {
+            return "CRASHED";
+        }
+        case "COMPLETED_WITH_ERRORS": {
+            return "FAILED";
+        }
+        case "EXPIRED": {
+            return "EXPIRED";
+        }
+        default: {
+            throw new Error(`Unknown status: ${status}`);
+        }
+    }
+}
+//# sourceMappingURL=runStream.js.map

package/dist/esm/v3/apiClient/runStream.js.map

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

package/dist/esm/v3/apiClient/stream.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export type ZodShapeStreamOptions = {
+    headers?: Record<string, string>;
+    fetchClient?: typeof fetch;
+    signal?: AbortSignal;
+};
+export declare function zodShapeStream<TShapeSchema extends z.ZodTypeAny>(schema: TShapeSchema, url: string, callback: (shape: z.output<TShapeSchema>) => void | Promise<void>, options?: ZodShapeStreamOptions): Promise<() => void>;
+export type AsyncIterableStream<T> = AsyncIterable<T> & ReadableStream<T>;
+export declare function createAsyncIterableStream<S, T>(source: ReadableStream<S>, transformer: Transformer<S, T>): AsyncIterableStream<T>;

package/dist/esm/v3/apiClient/stream.js

@@ -0,0 +1,33 @@
+export async function zodShapeStream(schema, url, callback, options) {
+    const { ShapeStream, Shape } = await import("@electric-sql/client");
+    const stream = new ShapeStream({
+        url,
+        headers: options?.headers,
+        fetchClient: options?.fetchClient,
+        signal: options?.signal,
+    });
+    const shape = new Shape(stream);
+    const initialValue = await shape.value;
+    for (const shapeRow of initialValue.values()) {
+        await callback(schema.parse(shapeRow));
+    }
+    return shape.subscribe(async (newShape) => {
+        for (const shapeRow of newShape.values()) {
+            await callback(schema.parse(shapeRow));
+        }
+    });
+}
+export function createAsyncIterableStream(source, transformer) {
+    const transformedStream = source.pipeThrough(new TransformStream(transformer));
+    transformedStream[Symbol.asyncIterator] = () => {
+        const reader = transformedStream.getReader();
+        return {
+            async next() {
+                const { done, value } = await reader.read();
+                return done ? { done: true, value: undefined } : { done: false, value };
+            },
+        };
+    };
+    return transformedStream;
+}
+//# sourceMappingURL=stream.js.map

package/dist/esm/v3/apiClient/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../../../src/v3/apiClient/stream.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAoB,EACpB,GAAW,EACX,QAAiE,EACjE,OAA+B;IAE/B,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAEpE,MAAM,MAAM,GAAG,IAAI,WAAW,CAAwB;QACpD,GAAG;QACH,OAAO,EAAE,OAAO,EAAE,OAAO;QACzB,WAAW,EAAE,OAAO,EAAE,WAAW;QACjC,MAAM,EAAE,OAAO,EAAE,MAAM;KACxB,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAEhC,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC;IAEvC,KAAK,MAAM,QAAQ,IAAI,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7C,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACxC,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAID,MAAM,UAAU,yBAAyB,CACvC,MAAyB,EACzB,WAA8B;IAE9B,MAAM,iBAAiB,GAAQ,MAAM,CAAC,WAAW,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;IAEpF,iBAAiB,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,EAAE,CAAC;QAC7C,OAAO;YACL,KAAK,CAAC,IAAI;gBACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC1E,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/esm/v3/apiClient/types.d.ts

@@ -31,3 +31,7 @@ export interface ListRunsQueryParams extends CursorPageParams {
 export interface ListProjectRunsQueryParams extends CursorPageParams, ListRunsQueryParams {
     env?: Array<"dev" | "staging" | "prod"> | "dev" | "staging" | "prod";
 }
+export interface SubscribeToRunsQueryParams {
+    tasks?: Array<string> | string;
+    tags?: Array<string> | string;
+}

package/dist/esm/v3/apiClientManager/index.d.ts

@@ -9,10 +9,11 @@ export declare class APIClientManagerAPI {
     private constructor();
     static getInstance(): APIClientManagerAPI;
     disable(): void;
-    setGlobalAPIClientConfiguration(config: ApiClientConfiguration): boolean;
     get baseURL(): string | undefined;
     get accessToken(): string | undefined;
     get client(): ApiClient | undefined;
     clientOrThrow(): ApiClient;
+    runWithConfig<R extends (...args: any[]) => Promise<any>>(config: ApiClientConfiguration, fn: R): Promise<ReturnType<R>>;
+    setGlobalAPIClientConfiguration(config: ApiClientConfiguration): boolean;
     apiClientMissingError(): "You need to set the TRIGGER_API_URL and TRIGGER_SECRET_KEY environment variables. See https://trigger.dev/docs/management/overview#authentication" | "You need to set the TRIGGER_API_URL environment variable. See https://trigger.dev/docs/management/overview#authentication" | "You need to set the TRIGGER_SECRET_KEY environment variable. See https://trigger.dev/docs/management/overview#authentication" | "Unknown error";
 }

package/dist/esm/v3/apiClientManager/index.js

@@ -20,16 +20,16 @@ export class APIClientManagerAPI {
     disable() {
         unregisterGlobal(API_NAME);
     }
-    setGlobalAPIClientConfiguration(config) {
-        return registerGlobal(API_NAME, config);
-    }
     get baseURL() {
-        const store = this.#getConfig();
-        return store?.baseURL ?? getEnvVar("TRIGGER_API_URL") ?? "https://api.trigger.dev";
+        const config = this.#getConfig();
+        return config?.baseURL ?? getEnvVar("TRIGGER_API_URL") ?? "https://api.trigger.dev";
     }
     get accessToken() {
-        const store = this.#getConfig();
-        return store?.secretKey ?? getEnvVar("TRIGGER_SECRET_KEY") ?? getEnvVar("TRIGGER_ACCESS_TOKEN");
+        const config = this.#getConfig();
+        return (config?.secretKey ??
+            config?.accessToken ??
+            getEnvVar("TRIGGER_SECRET_KEY") ??
+            getEnvVar("TRIGGER_ACCESS_TOKEN"));
     }
     get client() {
         if (!this.baseURL || !this.accessToken) {
@@ -43,6 +43,17 @@ export class APIClientManagerAPI {
         }
         return new ApiClient(this.baseURL, this.accessToken);
     }
+    runWithConfig(config, fn) {
+        const originalConfig = this.#getConfig();
+        const $config = { ...originalConfig, ...config };
+        registerGlobal(API_NAME, $config, true);
+        return fn().finally(() => {
+            registerGlobal(API_NAME, originalConfig, true);
+        });
+    }
+    setGlobalAPIClientConfiguration(config) {
+        return registerGlobal(API_NAME, config);
+    }
     #getConfig() {
         return getGlobal(API_NAME);
     }

package/dist/esm/v3/apiClientManager/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/apiClientManager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAC,SAAS,CAAuB;IAE/C,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAC7C,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,OAAO;QACZ,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAEM,+BAA+B,CAAC,MAA8B;QACnE,OAAO,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,OAAO;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,EAAE,OAAO,IAAI,SAAS,CAAC,iBAAiB,CAAC,IAAI,yBAAyB,CAAC;IACrF,CAAC;IAED,IAAI,WAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,EAAE,SAAS,IAAI,SAAS,CAAC,oBAAoB,CAAC,IAAI,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAClG,CAAC;IAED,IAAI,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,UAAU;QACR,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,qBAAqB;QACnB,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,EAAE,CAAC;YACnC,OAAO,mJAAmJ,CAAC;QAC7J,CAAC;aAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,2HAA2H,CAAC;QACrI,CAAC;aAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3B,OAAO,8HAA8H,CAAC;QACxI,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/apiClientManager/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/apiClientManager/types.d.ts

@@ -1,6 +1,13 @@
 import { type ApiRequestOptions } from "../apiClient/index.js";
 export type ApiClientConfiguration = {
     baseURL?: string;
+    /**
+     * @deprecated Use `accessToken` instead.
+     */
     secretKey?: string;
+    /**
+     * The access token to authenticate with the Trigger API.
+     */
+    accessToken?: string;
     requestOptions?: ApiRequestOptions;
 };

package/dist/esm/v3/apps/process.d.ts

@@ -1,2 +1,4 @@
+/** This was used by the old build system in case of indexing failures */
 export declare const EXIT_CODE_ALREADY_HANDLED = 111;
+/** This means what it says and is only set once we have completed the attempt */
 export declare const EXIT_CODE_CHILD_NONZERO = 112;

package/dist/esm/v3/apps/process.js

@@ -1,3 +1,5 @@
+/** This was used by the old build system in case of indexing failures */
 export const EXIT_CODE_ALREADY_HANDLED = 111;
+/** This means what it says and is only set once we have completed the attempt */
 export const EXIT_CODE_CHILD_NONZERO = 112;
 //# sourceMappingURL=process.js.map

package/dist/esm/v3/apps/process.js.map

@@ -1 +1 @@
-{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../../src/v3/apps/process.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC"}
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../../src/v3/apps/process.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,iFAAiF;AACjF,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC"}

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

@@ -7,10 +7,15 @@ import { ExceptionEventProperties } from "./schemas/openTelemetry.js";
 export declare class AbortTaskRunError extends Error {
     constructor(message: string);
 }
+export declare class TaskPayloadParsedError extends Error {
+    readonly cause: unknown;
+    constructor(cause: unknown);
+}
 export declare function parseError(error: unknown): TaskRunError;
 export declare function createErrorTaskError(error: TaskRunError): any;
 export declare function createJsonErrorObject(error: TaskRunError): SerializedError;
 export declare function sanitizeError(error: TaskRunError): TaskRunError;
+export declare function shouldRetryError(error: TaskRunError): boolean;
 export declare function correctErrorStackTrace(stackTrace: string, projectDir?: string, options?: {
     removeFirstLine?: boolean;
     isDev?: boolean;
@@ -65,11 +70,13 @@ export declare class SigKillTimeoutProcessError extends Error {
 export declare class GracefulExitTimeoutError extends Error {
     constructor();
 }
+type ErrorLink = {
+    name: string;
+    href: string;
+    magic?: "CONTACT_FORM";
+};
 type EnhanceError<T extends TaskRunError | ExceptionEventProperties> = T & {
-    link?: {
-        name: string;
-        href: string;
-    };
+    link?: ErrorLink;
 };
 export declare function taskRunErrorEnhancer(error: TaskRunError): EnhanceError<TaskRunError>;
 export declare function exceptionEventEnhancer(exception: ExceptionEventProperties): EnhanceError<ExceptionEventProperties>;

package/dist/esm/v3/errors.js

@@ -2,12 +2,22 @@ import { ImportTaskFileErrors } from "./schemas/build.js";
 import { TaskRunErrorCodes, } from "./schemas/common.js";
 import { TaskMetadataFailedToParseData } from "./schemas/messages.js";
 import { links } from "./links.js";
+import { assertExhaustive } from "../utils.js";
 export class AbortTaskRunError extends Error {
     constructor(message) {
         super(message);
         this.name = "AbortTaskRunError";
     }
 }
+export class TaskPayloadParsedError extends Error {
+    cause;
+    constructor(cause) {
+        const causeMessage = cause instanceof Error ? cause.message : String(cause);
+        super("Parsing payload with schema failed: " + causeMessage);
+        this.name = "TaskPayloadParsedError";
+        this.cause = cause;
+    }
+}
 export function parseError(error) {
     if (error instanceof Error) {
         return {
@@ -118,6 +128,54 @@ export function sanitizeError(error) {
         }
     }
 }
+export function shouldRetryError(error) {
+    switch (error.type) {
+        case "INTERNAL_ERROR": {
+            switch (error.code) {
+                case "COULD_NOT_FIND_EXECUTOR":
+                case "COULD_NOT_FIND_TASK":
+                case "COULD_NOT_IMPORT_TASK":
+                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":
+                    return false;
+                case "GRACEFUL_EXIT_TIMEOUT":
+                case "HANDLE_ERROR_ERROR":
+                case "TASK_INPUT_ERROR":
+                case "TASK_OUTPUT_ERROR":
+                case "POD_EVICTED":
+                case "POD_UNKNOWN_ERROR":
+                case "TASK_EXECUTION_ABORTED":
+                case "TASK_EXECUTION_FAILED":
+                case "TASK_RUN_CRASHED":
+                case "TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE":
+                case "TASK_PROCESS_SIGTERM":
+                    return true;
+                default:
+                    assertExhaustive(error.code);
+            }
+        }
+        case "STRING_ERROR": {
+            return true;
+        }
+        case "BUILT_IN_ERROR": {
+            return true;
+        }
+        case "CUSTOM_ERROR": {
+            return true;
+        }
+        default: {
+            assertExhaustive(error);
+        }
+    }
+}
 export function correctErrorStackTrace(stackTrace, projectDir, options) {
     const [errorLine, ...traceLines] = stackTrace.split("\n");
     return [
@@ -265,16 +323,86 @@ const prettyInternalErrors = {
             href: links.docs.machines.home,
         },
     },
+    TASK_PROCESS_SIGSEGV: {
+        message: "Your task crashed with a segmentation fault (SIGSEGV). Most likely there's a bug in a package or binary you're using. If this keeps happening and you're unsure why, please get in touch.",
+        link: {
+            name: "Contact us",
+            href: links.site.contact,
+            magic: "CONTACT_FORM",
+        },
+    },
+    TASK_PROCESS_SIGTERM: {
+        message: "Your task exited after receiving SIGTERM but we don't know why. If this keeps happening, please get in touch so we can investigate.",
+        link: {
+            name: "Contact us",
+            href: links.site.contact,
+            magic: "CONTACT_FORM",
+        },
+    },
+};
+const getPrettyTaskRunError = (code) => {
+    return {
+        type: "INTERNAL_ERROR",
+        code,
+        ...prettyInternalErrors[code],
+    };
+};
+const getPrettyExceptionEvent = (code) => {
+    return {
+        type: code,
+        ...prettyInternalErrors[code],
+    };
+};
+const findSignalInMessage = (message, truncateLength = 100) => {
+    if (!message) {
+        return;
+    }
+    const trunc = truncateLength ? message.slice(0, truncateLength) : message;
+    if (trunc.includes("SIGTERM")) {
+        return "SIGTERM";
+    }
+    else if (trunc.includes("SIGSEGV")) {
+        return "SIGSEGV";
+    }
+    else if (trunc.includes("SIGKILL")) {
+        return "SIGKILL";
+    }
+    else {
+        return;
+    }
 };
 export function taskRunErrorEnhancer(error) {
     switch (error.type) {
         case "BUILT_IN_ERROR": {
             if (error.name === "UnexpectedExitError") {
                 if (error.message.startsWith("Unexpected exit with code -1")) {
+                    const signal = findSignalInMessage(error.stackTrace);
+                    switch (signal) {
+                        case "SIGTERM":
+                            return {
+                                ...getPrettyTaskRunError("TASK_PROCESS_SIGTERM"),
+                            };
+                        case "SIGSEGV":
+                            return {
+                                ...getPrettyTaskRunError("TASK_PROCESS_SIGSEGV"),
+                            };
+                        case "SIGKILL":
+                            return {
+                                ...getPrettyTaskRunError("TASK_PROCESS_MAYBE_OOM_KILLED"),
+                            };
+                        default:
+                            return {
+                                ...getPrettyTaskRunError("TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE"),
+                                message: error.message,
+                                stackTrace: error.stackTrace,
+                            };
+                    }
+                }
+            }
+            if (error.name === "Error") {
+                if (error.message === "ffmpeg was killed with signal SIGKILL") {
                     return {
-                        type: "INTERNAL_ERROR",
-                        code: TaskRunErrorCodes.TASK_PROCESS_MAYBE_OOM_KILLED,
-                        ...prettyInternalErrors.TASK_PROCESS_MAYBE_OOM_KILLED,
+                        ...getPrettyTaskRunError("TASK_PROCESS_OOM_KILLED"),
                     };
                 }
             }
@@ -288,20 +416,33 @@ export function taskRunErrorEnhancer(error) {
         }
         case "INTERNAL_ERROR": {
             if (error.code === TaskRunErrorCodes.TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE) {
-                return {
-                    type: "INTERNAL_ERROR",
-                    code: TaskRunErrorCodes.TASK_PROCESS_MAYBE_OOM_KILLED,
-                    ...prettyInternalErrors.TASK_PROCESS_MAYBE_OOM_KILLED,
-                };
-            }
-            const prettyError = prettyInternalErrors[error.code];
-            if (prettyError) {
-                return {
-                    ...error,
-                    ...prettyError,
-                };
+                const signal = findSignalInMessage(error.message);
+                switch (signal) {
+                    case "SIGTERM":
+                        return {
+                            ...getPrettyTaskRunError("TASK_PROCESS_SIGTERM"),
+                        };
+                    case "SIGSEGV":
+                        return {
+                            ...getPrettyTaskRunError("TASK_PROCESS_SIGSEGV"),
+                        };
+                    case "SIGKILL":
+                        return {
+                            ...getPrettyTaskRunError("TASK_PROCESS_MAYBE_OOM_KILLED"),
+                        };
+                    default: {
+                        return {
+                            ...getPrettyTaskRunError("TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE"),
+                            message: error.message,
+                            stackTrace: error.stackTrace,
+                        };
+                    }
+                }
             }
-            break;
+            return {
+                ...error,
+                ...getPrettyTaskRunError(error.code),
+            };
         }
     }
     return error;
@@ -317,42 +458,88 @@ export function exceptionEventEnhancer(exception) {
             }
             break;
         }
+        case "Internal error": {
+            if (exception.message?.startsWith(TaskRunErrorCodes.TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE)) {
+                const signal = findSignalInMessage(exception.message);
+                switch (signal) {
+                    case "SIGTERM":
+                        return {
+                            ...exception,
+                            ...getPrettyExceptionEvent("TASK_PROCESS_SIGTERM"),
+                        };
+                    case "SIGSEGV":
+                        return {
+                            ...exception,
+                            ...getPrettyExceptionEvent("TASK_PROCESS_SIGSEGV"),
+                        };
+                    case "SIGKILL":
+                        return {
+                            ...exception,
+                            ...getPrettyExceptionEvent("TASK_PROCESS_MAYBE_OOM_KILLED"),
+                        };
+                    default:
+                        return exception;
+                }
+            }
+            break;
+        }
+        case "Error": {
+            if (exception.message === "ffmpeg was killed with signal SIGKILL") {
+                return {
+                    ...exception,
+                    ...prettyInternalErrors.TASK_PROCESS_OOM_KILLED,
+                };
+            }
+            break;
+        }
         case TaskRunErrorCodes.TASK_PROCESS_MAYBE_OOM_KILLED:
-        case TaskRunErrorCodes.TASK_PROCESS_OOM_KILLED: {
+        case TaskRunErrorCodes.TASK_PROCESS_OOM_KILLED:
+        case TaskRunErrorCodes.TASK_PROCESS_SIGTERM: {
             return {
                 ...exception,
-                ...prettyInternalErrors[exception.type],
+                ...getPrettyExceptionEvent(exception.type),
             };
         }
     }
     return exception;
 }
 export function internalErrorFromUnexpectedExit(error, dockerMode = true) {
+    const internalError = {
+        type: "INTERNAL_ERROR",
+        code: TaskRunErrorCodes.TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE,
+        message: `Process exited with code ${error.code} after signal ${error.signal}.`,
+        stackTrace: error.stderr,
+    };
     if (error.code === 137) {
         if (dockerMode) {
             return {
-                type: "INTERNAL_ERROR",
+                ...internalError,
                 code: TaskRunErrorCodes.TASK_PROCESS_OOM_KILLED,
             };
         }
         else {
             // Note: containerState reason and message could be checked to clarify the error, maybe the task monitor should be allowed to override these
             return {
-                type: "INTERNAL_ERROR",
+                ...internalError,
                 code: TaskRunErrorCodes.TASK_PROCESS_MAYBE_OOM_KILLED,
             };
         }
     }
     if (error.stderr?.includes("OOMErrorHandler")) {
         return {
-            type: "INTERNAL_ERROR",
+            ...internalError,
             code: TaskRunErrorCodes.TASK_PROCESS_OOM_KILLED,
         };
     }
+    if (error.signal === "SIGTERM") {
+        return {
+            ...internalError,
+            code: TaskRunErrorCodes.TASK_PROCESS_SIGTERM,
+        };
+    }
     return {
-        type: "INTERNAL_ERROR",
+        ...internalError,
         code: TaskRunErrorCodes.TASK_PROCESS_EXITED_WITH_NON_ZERO_CODE,
-        message: `Process exited with code ${error.code} after signal ${error.signal}.`,
     };
 }
 export function serializeIndexingError(error, stderr) {