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

package/dist/commonjs/v3/config.d.ts

@@ -1,15 +1,36 @@
 import type { Instrumentation } from "@opentelemetry/instrumentation";
-import type { SpanExporter } from "@opentelemetry/sdk-trace-base";
+import type { SpanExporter, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import type { MetricReader, PushMetricExporter } from "@opentelemetry/sdk-metrics";
 import type { BuildExtension } from "./build/extensions.js";
-import type { MachinePresetName } from "./schemas/common.js";
+import type { AnyOnFailureHookFunction, AnyOnInitHookFunction, AnyOnStartHookFunction, AnyOnSuccessHookFunction, ConfigRuntime, RetryOptions } from "./index.js";
 import type { LogLevel } from "./logger/taskLogger.js";
-import type { FailureFnParams, InitFnParams, StartFnParams, SuccessFnParams } from "./types/index.js";
-import type { BuildRuntime, RetryOptions } from "./index.js";
+import type { MachinePresetName } from "./schemas/common.js";
+import type { LogRecordExporter } from "@opentelemetry/sdk-logs";
+import type { Resource } from "@opentelemetry/resources";
+export type CompatibilityFlag = "run_engine_v2";
+export type CompatibilityFlagFeatures = {
+    [key in CompatibilityFlag]: boolean;
+};
+type ProcessKeepAlive = boolean | {
+    enabled: boolean;
+    /**
+     * The maximum number of executions per process. If the process has run more than this number of times, it will be killed.
+     *
+     * @default 50
+     */
+    maxExecutionsPerProcess?: number;
+    /**
+     * The maximum number of processes to keep alive in dev.
+     *
+     * @default 25
+     */
+    devMaxPoolSize?: number;
+};
 export type TriggerConfig = {
     /**
      * @default "node"
      */
-    runtime?: BuildRuntime;
+    runtime?: ConfigRuntime;
     /**
      * Specify the project ref for your trigger.dev tasks. This is the project ref that you get when you create a new project in the trigger.dev dashboard.
      */
@@ -61,6 +82,73 @@ export type TriggerConfig = {
          * @see https://trigger.dev/docs/config/config-file#exporters
          */
         exporters?: Array<SpanExporter>;
+        /**
+         * Span processors that run before any span is exported, to Trigger.dev or to your own `exporters`.
+         * Use them to redact or drop span content before it reaches the run trace.
+         *
+         * Redact in `onEnding`, where the span is complete and still writable. `onStart` runs before
+         * Trigger.dev adds run context, and in `onEnd` the span is read-only, so `setAttribute` is a
+         * no-op there. Content can also sit in span events (exceptions, for example), which live on
+         * `span.events`. Attributes Trigger.dev needs to link spans to the run are restored after your
+         * processor runs, and errors it throws are reported instead of failing the run.
+         *
+         * @example
+         * ```ts
+         * const EMAIL = /[\w.+-]+@[\w-]+\.[\w.]+/g;
+         * const redact = (value: AttributeValue | undefined): AttributeValue | undefined => {
+         *   if (typeof value === "string") return value.replace(EMAIL, "[email]");
+         *   if (Array.isArray(value)) {
+         *     return value.map((item) =>
+         *       typeof item === "string" ? item.replace(EMAIL, "[email]") : item
+         *     ) as AttributeValue;
+         *   }
+         *   return value;
+         * };
+         * const scrub = (attributes: Attributes) => {
+         *   for (const key of Object.keys(attributes)) attributes[key] = redact(attributes[key]);
+         * };
+         *
+         * const redactEmails: SpanProcessor = {
+         *   onStart: () => {},
+         *   onEnding: (span) => {
+         *     scrub(span.attributes);
+         *     for (const event of span.events) scrub(event.attributes ?? {});
+         *   },
+         *   onEnd: () => {},
+         *   forceFlush: async () => {},
+         *   shutdown: async () => {},
+         * };
+         *
+         * export default defineConfig({
+         *   telemetry: { spanProcessors: [redactEmails] },
+         * });
+         * ```
+         */
+        spanProcessors?: Array<SpanProcessor>;
+        /**
+         * Log exporters to use for OpenTelemetry. This is useful if you want to add custom log exporters to your tasks.
+         *
+         * @see https://trigger.dev/docs/config/config-file#exporters
+         */
+        logExporters?: Array<LogRecordExporter>;
+        /**
+         * Metric exporters to use for OpenTelemetry. This is useful if you want to export metrics to external services.
+         * Each exporter is automatically wrapped in a PeriodicExportingMetricReader.
+         *
+         * For more control over the reader configuration, use `metricReaders` instead.
+         */
+        metricExporters?: Array<PushMetricExporter>;
+        /**
+         * Metric readers for OpenTelemetry. Add custom metric readers to export
+         * metrics to external services alongside the default Trigger.dev exporter.
+         */
+        metricReaders?: Array<MetricReader>;
+        /**
+         * Resource to use for OpenTelemetry. This is useful if you want to add custom resources to your tasks.
+         *
+         * @see https://trigger.dev/docs/config/config-file#resource
+         */
+        resource?: Resource;
     };
     /**
      * Specify a custom path to your tsconfig file. This is useful if you have a custom tsconfig file that you want to use.
@@ -75,6 +163,7 @@ export type TriggerConfig = {
         enabledInDev?: boolean;
         default?: RetryOptions;
     };
+    compatibilityFlags?: Array<CompatibilityFlag>;
     /**
      * The default machine preset to use for your deployed trigger.dev tasks. You can override this on a per-task basis.
      * @default "small-1x"
@@ -100,10 +189,32 @@ export type TriggerConfig = {
      * @see https://trigger.dev/docs/tasks/overview#maxduration-option
      */
     maxDuration: number;
+    /**
+     * Set a default time-to-live (TTL) for all task runs in the project. If a run is not executed within this time, it will be removed from the queue and never execute.
+     *
+     * This can be a string like "1h" (1 hour), "30m" (30 minutes), "1d" (1 day), or a number of seconds.
+     *
+     * You can override this on a per-task basis by setting the `ttl` option on the task definition, or per-trigger by setting the `ttl` option when triggering.
+     *
+     * @example
+     *
+     * ```ts
+     * export default defineConfig({
+     *   project: "my-project",
+     *   maxDuration: 3600,
+     *   ttl: "1h",
+     * });
+     * ```
+     */
+    ttl?: string | number;
     /**
      * Enable console logging while running the dev CLI. This will print out logs from console.log, console.warn, and console.error. By default all logs are sent to the trigger.dev backend, and not logged to the console.
      */
     enableConsoleLogging?: boolean;
+    /**
+     * Disable the console interceptor. This will prevent logs from being sent to the trigger.dev backend.
+     */
+    disableConsoleInterceptor?: boolean;
     build?: {
         /**
          * Add custom conditions to the esbuild build. For example, if you are importing `ai/rsc`, you'll need to add "react-server" condition.
@@ -127,6 +238,45 @@ export type TriggerConfig = {
          * @see https://trigger.dev/docs/config/config-file#external
          */
         external?: string[];
+        /**
+         * This still works but use `autoDetectExternal` instead.
+         *
+         * @deprecated (use autoDetectExternal instead)
+         */
+        experimental_autoDetectExternal?: boolean;
+        /**
+         * Automatically detect dependencies that shouldn't be bundled and mark them as external. For example, native modules.
+         *
+         * Turn this off if you are having issues and want to manually specify all `external` dependencies.
+         *
+         * @default true
+         */
+        autoDetectExternal?: boolean;
+        /**
+         * This still works but use `keepNames` instead.
+         *
+         * @deprecated (use keepNames instead)
+         */
+        experimental_keepNames?: boolean;
+        keepNames?: boolean;
+        /**
+         * This still works but use `minify` instead.
+         *
+         * @deprecated (use minify instead)
+         */
+        experimental_minify?: boolean;
+        /**
+         * **WARNING: This is an experimental feature and might be removed in a future version.**
+         *
+         * "Minification is not safe for 100% of all JavaScript code" - esbuild docs
+         *
+         * Minify the generated code to help decrease bundle size. This may break stuff.
+         *
+         * @link https://esbuild.github.io/api/#minify
+         *
+         * @default false
+         */
+        minify?: boolean;
         jsx?: {
             /**
              * @default "React.createElement"
@@ -147,6 +297,29 @@ export type TriggerConfig = {
     deploy?: {
         env?: Record<string, string>;
     };
+    /**
+     * This still works but use `processKeepAlive` instead.
+     *
+     * @deprecated (use processKeepAlive instead)
+     */
+    experimental_processKeepAlive?: ProcessKeepAlive;
+    /**
+     * @default false
+     * @description Keep the process alive after the task has finished running so the next task doesn't have to wait for the process to start up again.
+     *
+     * Note that the process could be killed at any time, and we don't make any guarantees about the process being alive for a certain amount of time
+     */
+    processKeepAlive?: ProcessKeepAlive;
+    /**
+     * @default true
+     * @description If set to true when running the dev CLI, the current working directory will be set to where the command is run from.
+     *
+     * Setting this to `false` will set the current working directory to the build directory.
+     * This more closely matches the behavior of the CLI when running in production and is highly recommended.
+     *
+     * This impacts the value of process.cwd() in your task code.
+     */
+    legacyDevProcessCwdBehaviour?: boolean;
     /**
      * @deprecated Use `dirs` instead
      */
@@ -168,7 +341,7 @@ export type TriggerConfig = {
      */
     tsconfigPath?: string;
     /**
-     * CA Cert file to be added to NODE_EXTRA_CA_CERT environment variable in, useful in use with self signed cert in the trigger.dev environment.
+     * CA Cert file to be added to NODE_EXTRA_CA_CERT environment variable, useful in use with self signed cert in the trigger.dev environment.
      *
      * @example "./certs/ca.crt"
      * Note: must start with "./" and be relative to the project root.
@@ -177,22 +350,31 @@ export type TriggerConfig = {
     extraCACerts?: string;
     /**
      * Run before a task is executed, for all tasks. This is useful for setting up any global state that is needed for all tasks.
+     *
+     * @deprecated, please use tasks.init instead
      */
-    init?: (payload: unknown, params: InitFnParams) => void | Promise<void>;
+    init?: AnyOnInitHookFunction;
     /**
      * onSuccess is called after the run function has successfully completed.
+     *
+     * @deprecated, please use tasks.onSuccess instead
      */
-    onSuccess?: (payload: unknown, output: unknown, params: SuccessFnParams<any>) => Promise<void>;
+    onSuccess?: AnyOnSuccessHookFunction;
     /**
      * onFailure is called after a task run has failed (meaning the run function threw an error and won't be retried anymore)
+     *
+     * @deprecated, please use tasks.onFailure instead
      */
-    onFailure?: (payload: unknown, error: unknown, params: FailureFnParams<any>) => Promise<void>;
+    onFailure?: AnyOnFailureHookFunction;
     /**
      * onStart is called the first time a task is executed in a run (not before every retry)
+     *
+     * @deprecated, please use tasks.onStart instead
      */
-    onStart?: (payload: unknown, params: StartFnParams) => Promise<void>;
+    onStart?: AnyOnStartHookFunction;
     /**
      * @deprecated Use a custom build extension to add post install commands
      */
     postInstall?: string;
 };
+export {};

package/dist/commonjs/v3/consoleInterceptor.d.ts

@@ -3,7 +3,9 @@ export declare class ConsoleInterceptor {
     #private;
     private readonly logger;
     private readonly sendToStdIO;
-    constructor(logger: logsAPI.Logger, sendToStdIO: boolean);
+    private readonly interceptingDisabled;
+    private readonly maxAttributeCount?;
+    constructor(logger: logsAPI.Logger, sendToStdIO: boolean, interceptingDisabled: boolean, maxAttributeCount?: number | undefined);
     intercept<T>(console: Console, callback: () => Promise<T>): Promise<T>;
     debug(...args: unknown[]): void;
     log(...args: unknown[]): void;

package/dist/commonjs/v3/consoleInterceptor.js

@@ -13,13 +13,20 @@ const clock_api_js_1 = require("./clock-api.js");
 class ConsoleInterceptor {
     logger;
     sendToStdIO;
-    constructor(logger, sendToStdIO) {
+    interceptingDisabled;
+    maxAttributeCount;
+    constructor(logger, sendToStdIO, interceptingDisabled, maxAttributeCount) {
         this.logger = logger;
         this.sendToStdIO = sendToStdIO;
+        this.interceptingDisabled = interceptingDisabled;
+        this.maxAttributeCount = maxAttributeCount;
     }
     // Intercept the console and send logs to the OpenTelemetry logger
     // during the execution of the callback
     async intercept(console, callback) {
+        if (this.interceptingDisabled) {
+            return await callback();
+        }
         // Save the original console methods
         const originalConsole = {
             log: console.log,
@@ -77,7 +84,10 @@ class ConsoleInterceptor {
                 severityNumber,
                 severityText,
                 body: getLogMessage(parsed.value, severityText),
-                attributes: { ...this.#getAttributes(severityNumber), ...(0, flattenAttributes_js_1.flattenAttributes)(parsed.value) },
+                attributes: {
+                    ...this.#getAttributes(severityNumber),
+                    ...(0, flattenAttributes_js_1.flattenAttributes)(parsed.value, undefined, this.maxAttributeCount),
+                },
                 timestamp,
             });
             return;
@@ -126,7 +136,7 @@ function tryParseJSON(value) {
         }
         return { ok: false, value };
     }
-    catch (e) {
+    catch (_e) {
         return { ok: false, value };
     }
 }

package/dist/commonjs/v3/consoleInterceptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"consoleInterceptor.js","sourceRoot":"","sources":["../../../src/v3/consoleInterceptor.ts"],"names":[],"mappings":";;;;;;AACA,sDAAyD;AACzD,0DAA6B;AAC7B,yCAAmD;AACnD,mFAA6E;AAC7E,uEAAiE;AAEjE,iDAAuC;AAEvC,MAAa,kBAAkB;IAEV;IACA;IAFnB,YACmB,MAAsB,EACtB,WAAoB;QADpB,WAAM,GAAN,MAAM,CAAgB;QACtB,gBAAW,GAAX,WAAW,CAAS;IACpC,CAAC;IAEJ,kEAAkE;IAClE,uCAAuC;IACvC,KAAK,CAAC,SAAS,CAAI,OAAgB,EAAE,QAA0B;QAC7D,oCAAoC;QACpC,MAAM,eAAe,GAAG;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC;QAEF,+BAA+B;QAC/B,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,EAAE,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,uCAAuC;YACvC,OAAO,CAAC,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC;YAClC,OAAO,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;YACpC,OAAO,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;YACpC,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;YACtC,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;QACxC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,CAAC,UAAU,CAAC,yBAAc,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACxF,CAAC;IAED,GAAG,CAAC,GAAG,IAAe;QACpB,IAAI,CAAC,UAAU,CAAC,yBAAc,CAAC,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,CAAC,UAAU,CAAC,yBAAc,CAAC,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,CAAC,UAAU,CAAC,yBAAc,CAAC,IAAI,EAAE,IAAI,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,CAAC,UAAU,CAAC,yBAAc,CAAC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACxF,CAAC;IAED,UAAU,CACR,cAA8B,EAC9B,SAAoB,EACpB,YAAoB,EACpB,GAAG,IAAe;QAElB,MAAM,IAAI,GAAG,mBAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAElC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,cAAc,KAAK,yBAAc,CAAC,KAAK,EAAE,CAAC;gBAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAElC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,cAAc;gBACd,YAAY;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC;gBAC/C,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,GAAG,IAAA,wCAAiB,EAAC,MAAM,CAAC,KAAK,CAAC,EAAE;gBAC1F,SAAS;aACV,CAAC,CAAC;YAEH,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,cAAc;YACd,YAAY;YACZ,IAAI;YACJ,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC;YAC/C,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;QACnB,OAAO,oBAAK,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;IAED,cAAc,CAAC,cAA8B;QAC3C,MAAM,IAAI,GAAG,IAAA,gCAAqB,EAAC,cAAc,CAAC,CAAC;QACnD,IAAI,MAAM,GAA0B,EAAE,CAAC;QAEvC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,0DAA0B,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;QACvD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA9GD,gDA8GC;AAED,SAAS,aAAa,CAAC,KAA8B,EAAE,QAAgB;IACrE,IAAI,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CACnB,KAAa;IAEb,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEjC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACrC,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC"}
+{"version":3,"file":"consoleInterceptor.js","sourceRoot":"","sources":["../../../src/v3/consoleInterceptor.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,12 @@
-import { z } from "zod";
-import { DeploymentErrorData } from "./schemas/api.js";
-import { ImportTaskFileErrors, WorkerManifest } from "./schemas/build.js";
-import { SerializedError, TaskRunError, TaskRunErrorCodes, TaskRunInternalError } from "./schemas/common.js";
+import type { z } from "zod/v4";
+import type { DeploymentErrorData } from "./schemas/api.js";
+import type { WorkerManifest } from "./schemas/build.js";
+import { ImportTaskFileErrors } from "./schemas/build.js";
+import type { SerializedError, TaskRunError, TaskRunErrorCause, TaskRunInternalError } from "./schemas/common.js";
+import { TaskRunErrorCodes } from "./schemas/common.js";
 import { TaskMetadataFailedToParseData } from "./schemas/messages.js";
-import { ExceptionEventProperties } from "./schemas/openTelemetry.js";
+import type { ExceptionEventProperties } from "./schemas/openTelemetry.js";
+import type { ZodIssueLike } from "./types/schemas.js";
 /**
  * If you throw this, it will get converted into an INTERNAL_ERROR
  */
@@ -29,28 +32,58 @@ export declare class OutOfMemoryError extends Error {
     constructor();
 }
 export declare function isManualOutOfMemoryError(error: TaskRunError): boolean;
+export declare function isOOMRunError(error: TaskRunError): boolean;
 export declare class TaskPayloadParsedError extends Error {
     readonly cause: unknown;
     constructor(cause: unknown);
 }
+export declare class CompleteTaskWithOutput extends Error {
+    readonly output: unknown;
+    constructor(output?: unknown);
+}
+export declare function isCompleteTaskWithOutput(error: unknown): error is CompleteTaskWithOutput;
+/** 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. */
+export declare function truncateStack(stack: string | undefined, maxFrames?: number): string;
+export declare function truncateMessage(message: string | undefined): string;
+/** Rebuild a native `cause` chain from the flattened form, innermost first. */
+export declare function createErrorFromCauses(causes: TaskRunErrorCause[]): Error | undefined;
+/** 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. */
+export declare function formatErrorCauses(causes: TaskRunErrorCause[] | undefined, options?: {
+    stackTrace?: boolean;
+}): string;
 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 shouldLookupRetrySettings(error: TaskRunError): boolean;
 export declare function correctErrorStackTrace(stackTrace: string, projectDir?: string, options?: {
     removeFirstLine?: boolean;
     isDev?: boolean;
 }): string;
-export declare function groupTaskMetadataIssuesByTask(tasks: any, issues: z.ZodIssue[]): Record<number, {
-    id: any;
-    exportName: string;
-    filePath: string;
-    issues: Array<{
-        message: string;
-        path?: string;
-    }>;
-}>;
+export declare function groupTaskMetadataIssuesByTask(tasks: any, issues: ReadonlyArray<ZodIssueLike>): {
+    [x: number]: {
+        id: any;
+        exportName: any;
+        filePath: any;
+        issues: Array<{
+            message: string;
+            path?: string;
+        }>;
+    } | {
+        id: any;
+        exportName: string;
+        filePath: string;
+        issues: Array<{
+            message: string;
+            path?: string;
+        }>;
+    };
+};
 export declare class UncaughtExceptionError extends Error {
     readonly originalError: {
         name: string;
@@ -65,15 +98,50 @@ export declare class UncaughtExceptionError extends Error {
     }, origin: "uncaughtException" | "unhandledRejection");
 }
 export declare class TaskMetadataParseError extends Error {
-    readonly zodIssues: z.ZodIssue[];
+    readonly zodIssues: ReadonlyArray<ZodIssueLike>;
     readonly tasks: any;
-    constructor(zodIssues: z.ZodIssue[], tasks: any);
+    constructor(zodIssues: ReadonlyArray<ZodIssueLike>, tasks: any);
 }
 export declare class TaskIndexingImportError extends Error {
     readonly importErrors: ImportTaskFileErrors;
     readonly manifest: WorkerManifest;
     constructor(importErrors: ImportTaskFileErrors, manifest: WorkerManifest);
 }
+export type TaskIdCollision = {
+    id: string;
+    filePaths: string[];
+};
+export declare class DuplicateTaskIdsError extends Error {
+    readonly collisions: TaskIdCollision[];
+    constructor(collisions: TaskIdCollision[]);
+}
+/**
+ * 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.
+ */
+export declare class WebhookIndexingError extends Error {
+    readonly collisions: TaskIdCollision[];
+    readonly problems: string[];
+    constructor(collisions: TaskIdCollision[], problems?: string[]);
+}
+/** A webhook waiter was cancelled before a delivery matched it. */
+export declare class WebhookWaiterCancelledError extends Error {
+    constructor(message?: string);
+}
+export type WebhookWaiterLimitReason = "environment_limit" | "endpoint_limit" | "shape_limit" | "timeout_too_long";
+/** `webhooks.waiter.create` hit a waiter limit. Nothing was created. */
+export declare class WebhookWaiterLimitError extends Error {
+    readonly reason: WebhookWaiterLimitReason;
+    constructor(reason: WebhookWaiterLimitReason, message: string);
+}
+/** The endpoint isn't in this environment's current deployment. */
+export declare class WebhookEndpointNotFoundError extends Error {
+    constructor(message: string);
+}
+/** A waiter's filter didn't compile on the server. */
+export declare class WebhookFilterError extends Error {
+    constructor(message: string);
+}
 export declare class UnexpectedExitError extends Error {
     code: number;
     signal: NodeJS.Signals | null;
@@ -83,6 +151,9 @@ export declare class UnexpectedExitError extends Error {
 export declare class CleanupProcessError extends Error {
     constructor();
 }
+export declare class SuspendedProcessError extends Error {
+    constructor();
+}
 export declare class CancelledProcessError extends Error {
     constructor();
 }
@@ -92,6 +163,18 @@ export declare class SigKillTimeoutProcessError extends Error {
 export declare class GracefulExitTimeoutError extends Error {
     constructor();
 }
+export declare class ChatChunkTooLargeError extends Error {
+    readonly chunkSize: number;
+    readonly maxSize: number;
+    readonly chunkType?: string | undefined;
+    constructor(chunkSize: number, maxSize: number, chunkType?: string | undefined);
+}
+export declare function isChatChunkTooLargeError(error: unknown): error is ChatChunkTooLargeError;
+export declare class MaxDurationExceededError extends Error {
+    readonly maxDurationInSeconds: number;
+    readonly elapsedTimeInSeconds: number;
+    constructor(maxDurationInSeconds: number, elapsedTimeInSeconds: number);
+}
 type ErrorLink = {
     name: string;
     href: string;