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

package/dist/esm/v3/schemas/runEngine.js

@@ -0,0 +1,243 @@
+import { z } from "zod/v4";
+import { discriminatedUnion } from "../utils/zod.js";
+import { MachinePreset, TaskRunExecution } from "./common.js";
+import { EnvironmentType } from "./schemas.js";
+const anyString = z.custom((v) => typeof v === "string");
+export const TriggerSource = z
+    .enum(["sdk", "api", "dashboard", "cli", "mcp", "schedule"])
+    .or(anyString);
+export const TriggerAction = z.enum(["trigger", "replay", "test"]).or(anyString);
+export const TaskKind = z.enum(["STANDARD", "SCHEDULED", "AGENT"]).or(anyString);
+export const RunAnnotations = z.object({
+    triggerSource: TriggerSource,
+    triggerAction: TriggerAction,
+    rootTriggerSource: TriggerSource,
+    rootScheduleId: z.string().optional(),
+    taskKind: TaskKind.optional(),
+    externalDeploymentId: z.string().optional(),
+    /** The webhook delivery (friendly id) that triggered this run. */
+    webhookDeliveryId: z.string().optional(),
+    /** The endpoint (friendly id) that delivery arrived on. */
+    webhookEndpointId: z.string().optional(),
+    /** Where the most recently stamped attempt executed. Set by the supervisor at attempt start. */
+    workerCell: z.string().optional().catch(undefined),
+    workerLane: z.string().optional().catch(undefined),
+});
+/** Lenient read of the worker stamp: works on blobs that predate or fail RunAnnotations. */
+export const WorkerStampAnnotations = z.object({
+    workerCell: z.string().optional().catch(undefined),
+    workerLane: z.string().optional().catch(undefined),
+});
+export const TaskRunExecutionStatus = {
+    RUN_CREATED: "RUN_CREATED",
+    QUEUED: "QUEUED",
+    QUEUED_EXECUTING: "QUEUED_EXECUTING",
+    PENDING_EXECUTING: "PENDING_EXECUTING",
+    EXECUTING: "EXECUTING",
+    EXECUTING_WITH_WAITPOINTS: "EXECUTING_WITH_WAITPOINTS",
+    SUSPENDED: "SUSPENDED",
+    PENDING_CANCEL: "PENDING_CANCEL",
+    FINISHED: "FINISHED",
+    DELAYED: "DELAYED",
+};
+export const TaskRunStatus = {
+    DELAYED: "DELAYED",
+    PENDING: "PENDING",
+    PENDING_VERSION: "PENDING_VERSION",
+    WAITING_FOR_DEPLOY: "WAITING_FOR_DEPLOY",
+    DEQUEUED: "DEQUEUED",
+    EXECUTING: "EXECUTING",
+    WAITING_TO_RESUME: "WAITING_TO_RESUME",
+    RETRYING_AFTER_FAILURE: "RETRYING_AFTER_FAILURE",
+    PAUSED: "PAUSED",
+    CANCELED: "CANCELED",
+    INTERRUPTED: "INTERRUPTED",
+    COMPLETED_SUCCESSFULLY: "COMPLETED_SUCCESSFULLY",
+    COMPLETED_WITH_ERRORS: "COMPLETED_WITH_ERRORS",
+    SYSTEM_FAILURE: "SYSTEM_FAILURE",
+    CRASHED: "CRASHED",
+    EXPIRED: "EXPIRED",
+    TIMED_OUT: "TIMED_OUT",
+};
+export const WaitpointType = {
+    RUN: "RUN",
+    DATETIME: "DATETIME",
+    MANUAL: "MANUAL",
+    BATCH: "BATCH",
+};
+const WaitpointStatusValues = {
+    PENDING: "PENDING",
+    COMPLETED: "COMPLETED",
+};
+export const WaitpointStatus = z.enum(Object.values(WaitpointStatusValues));
+export const CompletedWaitpoint = z.object({
+    id: z.string(),
+    index: z.number().optional(),
+    friendlyId: z.string(),
+    type: z.enum(Object.values(WaitpointType)),
+    completedAt: z.coerce.date(),
+    idempotencyKey: z.string().optional(),
+    /** For type === "RUN" */
+    completedByTaskRun: z
+        .object({
+        id: z.string(),
+        friendlyId: z.string(),
+        /** If the run has an associated batch */
+        batch: z
+            .object({
+            id: z.string(),
+            friendlyId: z.string(),
+        })
+            .optional(),
+    })
+        .optional(),
+    /** For type === "DATETIME" */
+    completedAfter: z.coerce.date().optional(),
+    /** For type === "BATCH" */
+    completedByBatch: z
+        .object({
+        id: z.string(),
+        friendlyId: z.string(),
+    })
+        .optional(),
+    output: z.string().optional(),
+    outputType: z.string().optional(),
+    outputIsError: z.boolean(),
+});
+const ExecutionSnapshot = z.object({
+    id: z.string(),
+    friendlyId: z.string(),
+    executionStatus: z.enum(Object.values(TaskRunExecutionStatus)),
+    description: z.string(),
+    createdAt: z.coerce.date(),
+});
+const BaseRunMetadata = z.object({
+    id: z.string(),
+    friendlyId: z.string(),
+    status: z.enum(Object.values(TaskRunStatus)),
+    attemptNumber: z.number().nullish(),
+    taskEventStore: z.string().optional(),
+});
+export const ExecutionResult = z.object({
+    snapshot: ExecutionSnapshot,
+    run: BaseRunMetadata,
+});
+/** The response to the Worker when starting an attempt */
+export const StartRunAttemptResult = ExecutionResult.and(z.object({
+    execution: TaskRunExecution,
+}));
+/** The response to the Worker when completing an attempt */
+const CompleteAttemptStatus = z.enum([
+    "RUN_FINISHED",
+    "RUN_PENDING_CANCEL",
+    "RETRY_QUEUED",
+    "RETRY_IMMEDIATELY",
+]);
+export const CompleteRunAttemptResult = z
+    .object({
+    attemptStatus: CompleteAttemptStatus,
+})
+    .and(ExecutionResult);
+export const CheckpointTypeEnum = {
+    DOCKER: "DOCKER",
+    KUBERNETES: "KUBERNETES",
+    COMPUTE: "COMPUTE",
+};
+export const CheckpointType = z.enum(Object.values(CheckpointTypeEnum));
+export const CheckpointInput = z.object({
+    type: CheckpointType,
+    location: z.string(),
+    imageRef: z.string().nullish(),
+    reason: z.string().nullish(),
+});
+export const TaskRunCheckpoint = CheckpointInput.merge(z.object({
+    id: z.string(),
+    friendlyId: z.string(),
+}));
+/** The response when a Worker asks for the latest execution state */
+export const RunExecutionData = z.object({
+    version: z.literal("1"),
+    snapshot: ExecutionSnapshot,
+    run: BaseRunMetadata,
+    batch: z
+        .object({
+        id: z.string(),
+        friendlyId: z.string(),
+    })
+        .optional(),
+    checkpoint: TaskRunCheckpoint.optional(),
+    completedWaitpoints: z.array(CompletedWaitpoint),
+});
+export const CreateCheckpointResult = discriminatedUnion("ok", [
+    z
+        .object({
+        ok: z.literal(true),
+        checkpoint: TaskRunCheckpoint,
+    })
+        .merge(ExecutionResult),
+    z.object({
+        ok: z.literal(false),
+        error: z.string(),
+    }),
+]);
+export const MachineResources = z.object({
+    cpu: z.number(),
+    memory: z.number(),
+});
+export const DequeueMessageCheckpoint = z.object({
+    id: z.string(),
+    type: CheckpointType,
+    location: z.string(),
+    imageRef: z.string().nullish(),
+    reason: z.string().nullish(),
+});
+export const PlacementTag = z.object({
+    key: z.string(),
+    values: z.array(z.string()).optional(),
+});
+/** This is sent to a Worker when a run is dequeued (a new run or continuing run) */
+export const DequeuedMessage = z.object({
+    version: z.literal("1"),
+    snapshot: ExecutionSnapshot,
+    dequeuedAt: z.coerce.date(),
+    workerQueueLength: z.number().optional(),
+    image: z.string().optional(),
+    checkpoint: DequeueMessageCheckpoint.optional(),
+    completedWaitpoints: z.array(CompletedWaitpoint),
+    backgroundWorker: z.object({
+        id: z.string(),
+        friendlyId: z.string(),
+        version: z.string(),
+        // Canonical runtime identifier (e.g. "node", "node-22", "node-24", "bun")
+        runtime: z.string().optional(),
+    }),
+    deployment: z.object({
+        id: z.string().optional(),
+        friendlyId: z.string().optional(),
+        imagePlatform: z.string().optional(),
+    }),
+    run: z.object({
+        id: z.string(),
+        friendlyId: z.string(),
+        isTest: z.boolean(),
+        isReplay: z.boolean().default(false),
+        machine: MachinePreset,
+        attemptNumber: z.number(),
+        masterQueue: z.string(),
+        traceContext: z.record(z.string(), z.unknown()),
+        annotations: RunAnnotations.optional(),
+    }),
+    environment: z.object({
+        id: z.string(),
+        type: EnvironmentType,
+    }),
+    organization: z.object({
+        id: z.string(),
+        hasPrivateLink: z.boolean().optional(),
+    }),
+    project: z.object({
+        id: z.string(),
+    }),
+    placementTags: z.array(PlacementTag).optional(),
+});
+//# sourceMappingURL=runEngine.js.map

package/dist/esm/v3/schemas/runEngine.js.map

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

package/dist/esm/v3/schemas/scheduleWindow.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod/v4";
+export declare const MAX_ABSOLUTE_SCHEDULE_WINDOW_SECONDS: number;
+export type NormalizedScheduleWindow = {
+    type: "duration";
+    durationSeconds: number;
+} | {
+    type: "percentage";
+    percentage: number;
+};
+type Digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
+type DigitsBelow = {
+    "0": never;
+    "1": "0";
+    "2": "0" | "1";
+    "3": "0" | "1" | "2";
+    "4": "0" | "1" | "2" | "3";
+    "5": "0" | "1" | "2" | "3" | "4";
+    "6": "0" | "1" | "2" | "3" | "4" | "5";
+    "7": "0" | "1" | "2" | "3" | "4" | "5" | "6";
+    "8": "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7";
+    "9": "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8";
+};
+type DigitLength<Value extends string, Result extends 0[] = []> = Value extends `${Digit}${infer Rest}` ? DigitLength<Rest, [...Result, 0]> : Result;
+type CompareEqualLength<A extends string, B extends string> = A extends `${infer ADigit extends Digit}${infer ARest}` ? B extends `${infer BDigit extends Digit}${infer BRest}` ? ADigit extends BDigit ? CompareEqualLength<ARest, BRest> : ADigit extends DigitsBelow[BDigit] ? "lt" : "gt" : "eq" : "eq";
+type DecimalStringLTE<A extends string, B extends string> = DigitLength<A> extends DigitLength<B> ? CompareEqualLength<A, B> extends "gt" ? false : true : DigitLength<B> extends [...DigitLength<A>, ...0[]] ? true : false;
+type IsCanonicalUnsignedInteger<Value extends string> = Value extends `${bigint}` ? Value extends `-${string}` ? false : true : false;
+/** The literal validation error for a configured schedule window, or `never` when valid. */
+export type ScheduleWindowError<Window extends string> = string extends Window ? never : Window extends `${infer Amount}m` ? IsCanonicalUnsignedInteger<Amount> extends false ? "⛔ window must be a whole non-negative number" : DecimalStringLTE<Amount, "1440"> extends true ? never : "⛔ window duration cannot exceed 24 hours" : Window extends `${infer Amount}h` ? IsCanonicalUnsignedInteger<Amount> extends false ? "⛔ window must be a whole non-negative number" : DecimalStringLTE<Amount, "24"> extends true ? never : "⛔ window duration cannot exceed 24 hours" : Window extends `${infer Amount}%` ? IsCanonicalUnsignedInteger<Amount> extends false ? "⛔ percentage must be a whole non-negative number" : DecimalStringLTE<Amount, "100"> extends true ? never : "⛔ percentage cannot exceed 100%" : '⛔ window must look like "30m", "2h", or "50%"';
+/**
+ * Preserves valid schedule-window literals and replaces invalid literals with a descriptive type
+ * error. Wide `string` values pass through for authoritative runtime validation.
+ */
+export type ValidatedScheduleWindow<Window extends string | undefined> = Window extends string ? [ScheduleWindowError<Window>] extends [never] ? Window : ScheduleWindowError<Window> : Window;
+/** Parses and normalizes the public schedule-window syntax. */
+export declare function parseScheduleWindow(value: string): NormalizedScheduleWindow;
+/** Runtime authority for public schedule-window values. */
+export declare const ScheduleWindow: z.ZodString;
+export {};

package/dist/esm/v3/schemas/scheduleWindow.js

@@ -0,0 +1,38 @@
+import { z } from "zod/v4";
+export const MAX_ABSOLUTE_SCHEDULE_WINDOW_SECONDS = 24 * 60 * 60;
+/** Parses and normalizes the public schedule-window syntax. */
+export function parseScheduleWindow(value) {
+    const durationMatch = /^(0|[1-9]\d*)([mh])$/.exec(value);
+    if (durationMatch) {
+        const amount = Number(durationMatch[1]);
+        const unit = durationMatch[2];
+        const durationSeconds = amount * (unit === "m" ? 60 : 3_600);
+        if (!Number.isSafeInteger(durationSeconds) ||
+            durationSeconds > MAX_ABSOLUTE_SCHEDULE_WINDOW_SECONDS) {
+            throw new RangeError("Schedule window duration cannot exceed 24 hours");
+        }
+        return { type: "duration", durationSeconds };
+    }
+    const percentageMatch = /^(0|[1-9]\d*)%$/.exec(value);
+    if (percentageMatch) {
+        const percentage = Number(percentageMatch[1]);
+        if (!Number.isSafeInteger(percentage) || percentage > 100) {
+            throw new RangeError("Schedule window percentage cannot exceed 100%");
+        }
+        return { type: "percentage", percentage };
+    }
+    throw new TypeError('Schedule window must be a whole duration such as "30m" or "2h", or a percentage such as "30%"');
+}
+/** Runtime authority for public schedule-window values. */
+export const ScheduleWindow = z.string().superRefine((value, ctx) => {
+    try {
+        parseScheduleWindow(value);
+    }
+    catch (error) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: error instanceof Error ? error.message : String(error),
+        });
+    }
+});
+//# sourceMappingURL=scheduleWindow.js.map

package/dist/esm/v3/schemas/scheduleWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleWindow.js","sourceRoot":"","sources":["../../../../src/v3/schemas/scheduleWindow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,CAAC,MAAM,oCAAoC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAuFjE,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEzD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAc,CAAC;QAC3C,MAAM,eAAe,GAAG,MAAM,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAE7D,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC;YACtC,eAAe,GAAG,oCAAoC,EACtD,CAAC;YACD,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,eAAe,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;YAC1D,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,SAAS,CACjB,+FAA+F,CAChG,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAClE,IAAI,CAAC;QACH,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}