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

package/dist/esm/v3/runEngineWorker/supervisor/http.js

@@ -0,0 +1,242 @@
+import { z } from "zod/v4";
+import { WorkerApiConnectResponseBody, WorkerApiContinueRunExecutionRequestBody, WorkerApiDequeueResponseBody, WorkerApiHeartbeatResponseBody, WorkerApiRunAttemptCompleteResponseBody, WorkerApiRunAttemptStartResponseBody, WorkerApiRunHeartbeatResponseBody, WorkerApiRunLatestSnapshotResponseBody, WorkerApiRunRestoreOutcomeResponseBody, WorkerApiSuspendRunResponseBody, WorkerApiRunSnapshotsSinceResponseBody, } from "./schemas.js";
+import { retryContinueWithinBudget, } from "./continueRetry.js";
+import { getDefaultWorkerHeaders } from "./util.js";
+import { wrapZodFetch } from "../../zodfetch.js";
+import { createHeaders } from "../util.js";
+import { WORKER_HEADERS } from "../consts.js";
+import { SimpleStructuredLogger } from "../../utils/structuredLogger.js";
+export class SupervisorHttpClient {
+    apiUrl;
+    workerToken;
+    instanceName;
+    defaultHeaders;
+    sendRunDebugLogs;
+    resolveResponseSchema;
+    onHttpRequestComplete;
+    logger = new SimpleStructuredLogger("supervisor-http-client");
+    constructor(opts) {
+        this.apiUrl = opts.apiUrl.replace(/\/$/, "");
+        this.workerToken = opts.workerToken;
+        this.instanceName = opts.instanceName;
+        this.defaultHeaders = getDefaultWorkerHeaders(opts);
+        this.sendRunDebugLogs = opts.sendRunDebugLogs ?? false;
+        this.resolveResponseSchema = opts.resolveResponseSchema;
+        this.onHttpRequestComplete = opts.onHttpRequestComplete;
+        if (!this.apiUrl) {
+            throw new Error("apiURL is required and needs to be a non-empty string");
+        }
+        if (!this.workerToken) {
+            throw new Error("workerToken is required and needs to be a non-empty string");
+        }
+        if (!this.instanceName) {
+            throw new Error("instanceName is required and needs to be a non-empty string");
+        }
+    }
+    async request(name, schema, url, requestInit, options) {
+        const start = performance.now();
+        const result = await wrapZodFetch(this.resolveResponseSchema?.(schema) ?? schema, url, requestInit, options);
+        if (this.onHttpRequestComplete) {
+            const durationMs = performance.now() - start;
+            const method = requestInit?.method ?? "GET";
+            if (result.success) {
+                this.onHttpRequestComplete({ name, method, status: "2xx", outcome: "ok", durationMs });
+            }
+            else if (result.statusCode === 200) {
+                this.onHttpRequestComplete({
+                    name,
+                    method,
+                    status: "200",
+                    outcome: "invalid_response",
+                    durationMs,
+                });
+            }
+            else if (typeof result.statusCode === "number") {
+                this.onHttpRequestComplete({
+                    name,
+                    method,
+                    status: String(result.statusCode),
+                    outcome: "http_error",
+                    durationMs,
+                });
+            }
+            else {
+                this.onHttpRequestComplete({
+                    name,
+                    method,
+                    status: "none",
+                    outcome: "network_error",
+                    durationMs,
+                });
+            }
+        }
+        return result;
+    }
+    async connect(body) {
+        return this.request("connect", WorkerApiConnectResponseBody, `${this.apiUrl}/engine/v1/worker-actions/connect`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    async dequeue(body) {
+        return this.request("dequeue", WorkerApiDequeueResponseBody, `${this.apiUrl}/engine/v1/worker-actions/dequeue`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    async heartbeatWorker(body) {
+        return this.request("heartbeat_worker", WorkerApiHeartbeatResponseBody, `${this.apiUrl}/engine/v1/worker-actions/heartbeat`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    async heartbeatRun(runId, snapshotId, body, runnerId) {
+        return this.request("heartbeat_run", WorkerApiRunHeartbeatResponseBody, `${this.apiUrl}/engine/v1/worker-actions/runs/${runId}/snapshots/${snapshotId}/heartbeat`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders,
+                ...this.runnerIdHeader(runnerId),
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    async startRunAttempt(runId, snapshotId, body, runnerId, environmentId) {
+        return this.request("start_run_attempt", WorkerApiRunAttemptStartResponseBody, `${this.apiUrl}/engine/v1/worker-actions/runs/${runId}/snapshots/${snapshotId}/attempts/start`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders,
+                ...this.runnerIdHeader(runnerId),
+                ...this.environmentIdHeader(environmentId),
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    async completeRunAttempt(runId, snapshotId, body, runnerId, environmentId) {
+        return this.request("complete_run_attempt", WorkerApiRunAttemptCompleteResponseBody, `${this.apiUrl}/engine/v1/worker-actions/runs/${runId}/snapshots/${snapshotId}/attempts/complete`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders,
+                ...this.runnerIdHeader(runnerId),
+                ...this.environmentIdHeader(environmentId),
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    async getLatestSnapshot(runId, runnerId, environmentId) {
+        return this.request("get_latest_snapshot", WorkerApiRunLatestSnapshotResponseBody, `${this.apiUrl}/engine/v1/worker-actions/runs/${runId}/snapshots/latest`, {
+            method: "GET",
+            headers: {
+                ...this.defaultHeaders,
+                ...this.runnerIdHeader(runnerId),
+                ...this.environmentIdHeader(environmentId),
+            },
+        });
+    }
+    async getSnapshotsSince(runId, snapshotId, runnerId, environmentId) {
+        return this.request("get_snapshots_since", WorkerApiRunSnapshotsSinceResponseBody, `${this.apiUrl}/engine/v1/worker-actions/runs/${runId}/snapshots/since/${snapshotId}`, {
+            method: "GET",
+            headers: {
+                ...this.defaultHeaders,
+                ...this.runnerIdHeader(runnerId),
+                ...this.environmentIdHeader(environmentId),
+            },
+        });
+    }
+    async sendDebugLog(runId, body, runnerId) {
+        if (!this.sendRunDebugLogs) {
+            return;
+        }
+        try {
+            const res = await this.request("send_debug_log", z.unknown(), `${this.apiUrl}/engine/v1/worker-actions/runs/${runId}/logs/debug`, {
+                method: "POST",
+                headers: {
+                    ...this.defaultHeaders,
+                    ...this.runnerIdHeader(runnerId),
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+            });
+            if (!res.success) {
+                this.logger.error("Failed to send debug log", { error: res.error });
+            }
+        }
+        catch (error) {
+            this.logger.error("Failed to send debug log (caught error)", { error });
+        }
+    }
+    async continueRunExecution(runId, snapshotId, runnerId, environmentId, options) {
+        const continueRun = (retry, signal) => this.request("continue_run_execution", WorkerApiContinueRunExecutionRequestBody, `${this.apiUrl}/engine/v1/worker-actions/runs/${runId}/snapshots/${snapshotId}/continue`, {
+            method: "GET",
+            headers: {
+                ...this.defaultHeaders,
+                ...this.runnerIdHeader(runnerId),
+                ...this.environmentIdHeader(environmentId),
+            },
+            signal,
+        }, { retry });
+        if (options?.retryBudget) {
+            // Each attempt is a single request; the budget decides whether and when to try again.
+            return retryContinueWithinBudget((signal) => continueRun({ maxAttempts: 1 }, signal), options.retryBudget);
+        }
+        // This is the hop that reaches the engine, so it's where a transient
+        // database outage during resume surfaces (as a retryable 5xx). Resuming
+        // is idempotent server-side (guarded by the snapshot id), so retry
+        // generously to ride out the outage rather than aborting the run.
+        // `randomize` jitters the delay so a fleet of runs resuming at once
+        // doesn't stampede the DB the moment it recovers.
+        return continueRun({
+            minTimeoutInMs: 500,
+            maxTimeoutInMs: 10_000,
+            maxAttempts: 8,
+            factor: 2,
+            randomize: true,
+        });
+    }
+    async reportRestoreOutcome(runId, snapshotId, body, runnerId, environmentId) {
+        return this.request("report_restore_outcome", WorkerApiRunRestoreOutcomeResponseBody, `${this.apiUrl}/engine/v1/worker-actions/runs/${runId}/snapshots/${snapshotId}/restore-outcome`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders,
+                ...this.runnerIdHeader(runnerId),
+                ...this.environmentIdHeader(environmentId),
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    async submitSuspendCompletion({ runId, snapshotId, runnerId, body, }) {
+        return this.request("submit_suspend_completion", WorkerApiSuspendRunResponseBody, `${this.apiUrl}/engine/v1/worker-actions/runs/${runId}/snapshots/${snapshotId}/suspend`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders,
+                ...this.runnerIdHeader(runnerId),
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    runnerIdHeader(runnerId) {
+        return createHeaders({
+            [WORKER_HEADERS.RUNNER_ID]: runnerId,
+        });
+    }
+    environmentIdHeader(environmentId) {
+        return createHeaders({
+            [WORKER_HEADERS.ENVIRONMENT_ID]: environmentId,
+        });
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/esm/v3/runEngineWorker/supervisor/http.js.map

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

package/dist/esm/v3/runEngineWorker/supervisor/queueConsumer.d.ts

@@ -0,0 +1,45 @@
+import type { SupervisorHttpClient } from "./http.js";
+import type { WeightedWorkerQueueSubscription } from "../workerQueue.js";
+import type { WorkerApiDequeueResponseBody, WorkerQueueClass } from "./schemas.js";
+import type { PreDequeueFn, PreSkipFn } from "./types.js";
+import type { ConsumerPoolMetrics } from "./consumerPoolMetrics.js";
+export interface QueueConsumer {
+    start(): void;
+    stop(): void;
+}
+export type RunQueueConsumerOptions = {
+    client: SupervisorHttpClient;
+    intervalMs: number;
+    idleIntervalMs: number;
+    preDequeue?: PreDequeueFn;
+    preSkip?: PreSkipFn;
+    /** Which worker-queue class this consumer pulls from. Defaults to the worker's region queue. */
+    queueClass?: WorkerQueueClass;
+    subscriptions?: WeightedWorkerQueueSubscription[];
+    onDequeue: (messages: WorkerApiDequeueResponseBody, timing?: {
+        dequeueResponseMs: number;
+        pollingIntervalMs: number;
+    }) => Promise<void>;
+    /** Optional shared pool metrics. When provided, dequeue API latency is recorded as a histogram. */
+    metrics?: ConsumerPoolMetrics;
+};
+export declare class RunQueueConsumer implements QueueConsumer {
+    private readonly client;
+    private readonly preDequeue?;
+    private readonly preSkip?;
+    private readonly queueClass?;
+    private readonly subscriptions?;
+    private readonly onDequeue;
+    private readonly metrics?;
+    private readonly logger;
+    private intervalMs;
+    private idleIntervalMs;
+    private isEnabled;
+    private lastScheduledIntervalMs;
+    private rejectionBackoffMs;
+    constructor(opts: RunQueueConsumerOptions);
+    start(): void;
+    stop(): void;
+    private dequeue;
+    private scheduleNextDequeue;
+}

package/dist/esm/v3/runEngineWorker/supervisor/queueConsumer.js

@@ -0,0 +1,135 @@
+import { SimpleStructuredLogger } from "../../utils/structuredLogger.js";
+const DEQUEUE_REJECTION_BACKOFF_MIN_MS = 1_000;
+const DEQUEUE_REJECTION_BACKOFF_MAX_MS = 30_000;
+export class RunQueueConsumer {
+    client;
+    preDequeue;
+    preSkip;
+    queueClass;
+    subscriptions;
+    onDequeue;
+    metrics;
+    logger = new SimpleStructuredLogger("queue-consumer");
+    intervalMs;
+    idleIntervalMs;
+    isEnabled;
+    lastScheduledIntervalMs;
+    rejectionBackoffMs = 0;
+    constructor(opts) {
+        this.isEnabled = false;
+        this.intervalMs = opts.intervalMs;
+        this.idleIntervalMs = opts.idleIntervalMs;
+        this.preDequeue = opts.preDequeue;
+        this.preSkip = opts.preSkip;
+        this.queueClass = opts.queueClass;
+        this.subscriptions = opts.subscriptions;
+        this.lastScheduledIntervalMs = opts.idleIntervalMs;
+        this.onDequeue = opts.onDequeue;
+        this.client = opts.client;
+        this.metrics = opts.metrics;
+    }
+    start() {
+        if (this.isEnabled) {
+            return;
+        }
+        this.isEnabled = true;
+        this.dequeue();
+    }
+    stop() {
+        if (!this.isEnabled) {
+            return;
+        }
+        this.isEnabled = false;
+    }
+    async dequeue() {
+        this.logger.verbose("dequeue()", {
+            enabled: this.isEnabled,
+            intervalMs: this.intervalMs,
+            idleIntervalMs: this.idleIntervalMs,
+            preDequeue: !!this.preDequeue,
+            preSkip: !!this.preSkip,
+        });
+        if (!this.isEnabled) {
+            this.logger.warn("dequeue() - not enabled");
+            return;
+        }
+        let preDequeueResult;
+        if (this.preDequeue) {
+            this.logger.verbose("preDequeue()");
+            try {
+                preDequeueResult = await this.preDequeue();
+            }
+            catch (preDequeueError) {
+                this.logger.error("preDequeue error", { error: preDequeueError });
+            }
+        }
+        this.logger.verbose("preDequeueResult", { preDequeueResult });
+        if (preDequeueResult?.skipDequeue ||
+            preDequeueResult?.maxResources?.cpu === 0 ||
+            preDequeueResult?.maxResources?.memory === 0) {
+            this.logger.debug("skipping dequeue", { preDequeueResult });
+            if (this.preSkip) {
+                this.logger.debug("preSkip()");
+                try {
+                    await this.preSkip();
+                }
+                catch (preSkipError) {
+                    this.logger.error("preSkip error", { error: preSkipError });
+                }
+            }
+            this.scheduleNextDequeue(this.idleIntervalMs);
+            return;
+        }
+        let nextIntervalMs = this.idleIntervalMs;
+        const dequeueStart = performance.now();
+        try {
+            const response = await this.client.dequeue({
+                maxResources: preDequeueResult?.maxResources,
+                queueClass: this.queueClass,
+                subscriptions: this.subscriptions,
+            });
+            const dequeueDurationSeconds = (performance.now() - dequeueStart) / 1000;
+            const dequeueResponseMs = Math.round(dequeueDurationSeconds * 1000);
+            if (!response.success) {
+                this.metrics?.observeDequeueLatency(dequeueDurationSeconds, "error");
+                this.logger.error("Failed to dequeue", { error: response.error });
+                if (response.statusCode === 403 || response.statusCode === 422) {
+                    this.rejectionBackoffMs = Math.min(Math.max(DEQUEUE_REJECTION_BACKOFF_MIN_MS, this.rejectionBackoffMs * 2), DEQUEUE_REJECTION_BACKOFF_MAX_MS);
+                    nextIntervalMs = Math.max(this.idleIntervalMs, this.rejectionBackoffMs);
+                }
+            }
+            else {
+                this.rejectionBackoffMs = 0;
+                this.metrics?.observeDequeueLatency(dequeueDurationSeconds, response.data.length > 0 ? "success" : "empty");
+                try {
+                    await this.onDequeue(response.data, {
+                        dequeueResponseMs,
+                        pollingIntervalMs: this.lastScheduledIntervalMs,
+                    });
+                    if (response.data.length > 0) {
+                        nextIntervalMs = this.intervalMs;
+                    }
+                }
+                catch (handlerError) {
+                    this.logger.error("onDequeue error", { error: handlerError });
+                }
+            }
+        }
+        catch (clientError) {
+            // wrapZodFetch traps all errors into { success: false }, so this branch is
+            // unreachable with the real client today. Record defensively so a future
+            // client that throws can't silently lose error samples.
+            this.metrics?.observeDequeueLatency((performance.now() - dequeueStart) / 1000, "error");
+            this.logger.error("client.dequeue error", { error: clientError });
+        }
+        this.scheduleNextDequeue(nextIntervalMs);
+    }
+    scheduleNextDequeue(delayMs) {
+        if (delayMs === this.idleIntervalMs && this.idleIntervalMs !== this.intervalMs) {
+            this.logger.verbose("scheduled dequeue with idle interval", { delayMs });
+        }
+        this.lastScheduledIntervalMs = delayMs;
+        setTimeout(this.dequeue.bind(this), delayMs);
+    }
+}
+//# sourceMappingURL=queueConsumer.js.map

package/dist/esm/v3/runEngineWorker/supervisor/queueConsumer.js.map

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

package/dist/esm/v3/runEngineWorker/supervisor/queueMetricsProcessor.d.ts

@@ -0,0 +1,76 @@
+export interface QueueMetricsProcessorOptions {
+    /**
+     * EWMA smoothing factor (0-1)
+     * Lower values = more smoothing, less reactive
+     * Higher values = more responsive to recent changes
+     */
+    ewmaAlpha: number;
+    /**
+     * Batch window duration in milliseconds
+     * Samples within this window are collected and processed together
+     */
+    batchWindowMs: number;
+}
+export interface BatchProcessingResult {
+    /** Median of samples in the batch */
+    median: number;
+    /** EWMA-smoothed value after processing this batch */
+    smoothedValue: number;
+    /** Number of samples processed in this batch */
+    sampleCount: number;
+    /** Raw samples that were processed */
+    samples: readonly number[];
+}
+/**
+ * Processes queue length samples using exponential weighted moving average (EWMA)
+ * for smoothing and median filtering for outlier resistance.
+ *
+ * Collects samples within a batch window, calculates median to filter outliers,
+ * then applies EWMA smoothing for stable trend tracking.
+ */
+export declare class QueueMetricsProcessor {
+    private readonly ewmaAlpha;
+    private readonly batchWindowMs;
+    private readonly logger;
+    private samples;
+    private smoothedValue;
+    private lastBatchTime;
+    private isInitialized;
+    constructor(options: QueueMetricsProcessorOptions);
+    /**
+     * Adds a sample to the current batch
+     */
+    addSample(value: number, timestamp?: number): void;
+    /**
+     * Checks if enough time has passed to process the current batch
+     */
+    shouldProcessBatch(currentTime?: number): boolean;
+    private calculateMedian;
+    /**
+     * Processes the current batch of samples and returns the result.
+     * Clears the samples array and updates the smoothed value.
+     *
+     * Returns null if there are no samples to process.
+     */
+    processBatch(currentTime?: number): BatchProcessingResult | null;
+    /**
+     * Gets the current smoothed value without processing a batch
+     */
+    getSmoothedValue(): number;
+    /**
+     * Gets the number of samples in the current batch
+     */
+    getCurrentSampleCount(): number;
+    /**
+     * Gets the current samples (for testing/debugging)
+     */
+    getCurrentSamples(): readonly number[];
+    /**
+     * Resets the processor state
+     */
+    reset(): void;
+    /**
+     * Gets processor configuration
+     */
+    getConfig(): Readonly<QueueMetricsProcessorOptions>;
+}