@trigger.dev/core 0.0.0-v3-prerelease-20250108141813 → 0.0.0-v4-prerelease-20250916125920

package/dist/commonjs/v3/runEngineWorker/supervisor/consumerPoolMetrics.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsumerPoolMetrics = void 0;
+const prom_client_1 = require("prom-client");
+class ConsumerPoolMetrics {
+    register;
+    prefix;
+    // Current state metrics
+    consumerCount;
+    queueLength;
+    smoothedQueueLength;
+    targetConsumerCount;
+    scalingStrategy;
+    // Scaling operation metrics
+    scalingOperationsTotal;
+    consumersAddedTotal;
+    consumersRemovedTotal;
+    scalingCooldownsApplied;
+    // Performance metrics
+    queueLengthUpdatesTotal;
+    batchesProcessedTotal;
+    constructor(opts = {}) {
+        this.register = opts.register ?? new prom_client_1.Registry();
+        this.prefix = opts.prefix ?? "queue_consumer_pool";
+        // Current state metrics
+        this.consumerCount = new prom_client_1.Gauge({
+            name: `${this.prefix}_consumer_count`,
+            help: "Current number of active queue consumers",
+            labelNames: ["strategy"],
+            registers: [this.register],
+        });
+        this.queueLength = new prom_client_1.Gauge({
+            name: `${this.prefix}_queue_length`,
+            help: "Current queue length (median of recent samples)",
+            registers: [this.register],
+        });
+        this.smoothedQueueLength = new prom_client_1.Gauge({
+            name: `${this.prefix}_smoothed_queue_length`,
+            help: "EWMA smoothed queue length",
+            registers: [this.register],
+        });
+        this.targetConsumerCount = new prom_client_1.Gauge({
+            name: `${this.prefix}_target_consumer_count`,
+            help: "Target number of consumers calculated by scaling strategy",
+            labelNames: ["strategy"],
+            registers: [this.register],
+        });
+        this.scalingStrategy = new prom_client_1.Gauge({
+            name: `${this.prefix}_scaling_strategy_info`,
+            help: "Information about the active scaling strategy (1 = active, 0 = inactive)",
+            labelNames: ["strategy"],
+            registers: [this.register],
+        });
+        // Scaling operation metrics
+        this.scalingOperationsTotal = new prom_client_1.Counter({
+            name: `${this.prefix}_scaling_operations_total`,
+            help: "Total number of scaling operations performed",
+            labelNames: ["direction", "strategy"],
+            registers: [this.register],
+        });
+        this.consumersAddedTotal = new prom_client_1.Counter({
+            name: `${this.prefix}_consumers_added_total`,
+            help: "Total number of consumers added",
+            registers: [this.register],
+        });
+        this.consumersRemovedTotal = new prom_client_1.Counter({
+            name: `${this.prefix}_consumers_removed_total`,
+            help: "Total number of consumers removed",
+            registers: [this.register],
+        });
+        this.scalingCooldownsApplied = new prom_client_1.Counter({
+            name: `${this.prefix}_scaling_cooldowns_applied_total`,
+            help: "Number of times scaling was prevented due to cooldown",
+            labelNames: ["direction"],
+            registers: [this.register],
+        });
+        this.queueLengthUpdatesTotal = new prom_client_1.Counter({
+            name: `${this.prefix}_queue_length_updates_total`,
+            help: "Total number of queue length updates received",
+            registers: [this.register],
+        });
+        this.batchesProcessedTotal = new prom_client_1.Counter({
+            name: `${this.prefix}_batches_processed_total`,
+            help: "Total number of metric batches processed",
+            registers: [this.register],
+        });
+    }
+    /**
+     * Update all gauge metrics with current state
+     */
+    updateState(state) {
+        this.consumerCount.set({ strategy: state.strategy }, state.consumerCount);
+        if (state.queueLength !== undefined) {
+            this.queueLength.set(state.queueLength);
+        }
+        this.smoothedQueueLength.set(state.smoothedQueueLength);
+        this.targetConsumerCount.set({ strategy: state.strategy }, state.targetConsumerCount);
+        // Set strategy info (1 for active strategy, 0 for others)
+        ["none", "smooth", "aggressive"].forEach((s) => {
+            this.scalingStrategy.set({ strategy: s }, s === state.strategy ? 1 : 0);
+        });
+    }
+    /**
+     * Record a scaling operation
+     */
+    recordScalingOperation(direction, strategy, count) {
+        if (direction !== "none") {
+            this.scalingOperationsTotal.inc({ direction, strategy });
+            if (direction === "up") {
+                this.consumersAddedTotal.inc(count);
+            }
+            else {
+                this.consumersRemovedTotal.inc(count);
+            }
+        }
+    }
+    /**
+     * Record that scaling was prevented by cooldown
+     */
+    recordCooldownApplied(direction) {
+        this.scalingCooldownsApplied.inc({ direction });
+    }
+    /**
+     * Record a queue length update
+     */
+    recordQueueLengthUpdate() {
+        this.queueLengthUpdatesTotal.inc();
+    }
+}
+exports.ConsumerPoolMetrics = ConsumerPoolMetrics;
+//# sourceMappingURL=consumerPoolMetrics.js.map

package/dist/commonjs/v3/runEngineWorker/supervisor/consumerPoolMetrics.js.map

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

package/dist/commonjs/v3/runEngineWorker/supervisor/events.d.ts

@@ -0,0 +1,49 @@
+import { TaskRunExecutionResult } from "../../schemas/common.js";
+import { DequeuedMessage, StartRunAttemptResult } from "../../schemas/runEngine.js";
+export type WorkerEvents = {
+    runQueueMessage: [
+        {
+            time: Date;
+            message: DequeuedMessage;
+        }
+    ];
+    requestRunAttemptStart: [
+        {
+            time: Date;
+            run: {
+                friendlyId: string;
+            };
+            snapshot: {
+                friendlyId: string;
+            };
+        }
+    ];
+    runAttemptStarted: [
+        {
+            time: Date;
+        } & StartRunAttemptResult & {
+            envVars: Record<string, string>;
+        }
+    ];
+    runAttemptCompleted: [
+        {
+            time: Date;
+            run: {
+                friendlyId: string;
+            };
+            snapshot: {
+                friendlyId: string;
+            };
+            completion: TaskRunExecutionResult;
+        }
+    ];
+    runNotification: [
+        {
+            time: Date;
+            run: {
+                friendlyId: string;
+            };
+        }
+    ];
+};
+export type WorkerEventArgs<T extends keyof WorkerEvents> = WorkerEvents[T];

package/dist/commonjs/v3/runEngineWorker/supervisor/events.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=events.js.map

package/dist/commonjs/v3/runEngineWorker/supervisor/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../../src/v3/runEngineWorker/supervisor/events.ts"],"names":[],"mappings":""}

package/dist/commonjs/v3/runEngineWorker/supervisor/http.d.ts

@@ -0,0 +1,465 @@
+import { WorkerApiConnectRequestBody, WorkerApiDequeueRequestBody, WorkerApiHeartbeatRequestBody, WorkerApiRunAttemptCompleteRequestBody, WorkerApiRunAttemptStartRequestBody, WorkerApiRunHeartbeatRequestBody, WorkerApiDebugLogBody, WorkerApiSuspendRunRequestBody } from "./schemas.js";
+import { SupervisorClientCommonOptions } from "./types.js";
+type SupervisorHttpClientOptions = SupervisorClientCommonOptions;
+export declare class SupervisorHttpClient {
+    private readonly apiUrl;
+    private readonly workerToken;
+    private readonly instanceName;
+    private readonly defaultHeaders;
+    private readonly sendRunDebugLogs;
+    private readonly logger;
+    constructor(opts: SupervisorHttpClientOptions);
+    connect(body: WorkerApiConnectRequestBody): Promise<import("../../zodfetch.js").ApiResult<{
+        ok: true;
+        workerGroup: {
+            type: string;
+            name: string;
+        };
+    }>>;
+    dequeue(body: WorkerApiDequeueRequestBody): Promise<import("../../zodfetch.js").ApiResult<{
+        version: "1";
+        environment: {
+            type: "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
+            id: string;
+        };
+        organization: {
+            id: string;
+        };
+        project: {
+            id: string;
+        };
+        deployment: {
+            id?: string | undefined;
+            friendlyId?: string | undefined;
+            imagePlatform?: string | undefined;
+        };
+        run: {
+            id: string;
+            isTest: boolean;
+            machine: {
+                cpu: number;
+                memory: number;
+                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
+                centsPerMs: number;
+            };
+            traceContext: Record<string, unknown>;
+            friendlyId: string;
+            attemptNumber: number;
+            masterQueue: string;
+        };
+        snapshot: {
+            id: string;
+            createdAt: Date;
+            description: string;
+            friendlyId: string;
+            executionStatus: import("../../index.js").TaskRunExecutionStatus;
+        };
+        completedWaitpoints: {
+            type: import("../../index.js").WaitpointType;
+            id: string;
+            friendlyId: string;
+            completedAt: Date;
+            outputIsError: boolean;
+            idempotencyKey?: string | undefined;
+            output?: string | undefined;
+            outputType?: string | undefined;
+            index?: number | undefined;
+            completedByTaskRun?: {
+                id: string;
+                friendlyId: string;
+                batch?: {
+                    id: string;
+                    friendlyId: string;
+                } | undefined;
+            } | undefined;
+            completedAfter?: Date | undefined;
+            completedByBatch?: {
+                id: string;
+                friendlyId: string;
+            } | undefined;
+        }[];
+        dequeuedAt: Date;
+        backgroundWorker: {
+            id: string;
+            version: string;
+            friendlyId: string;
+        };
+        checkpoint?: {
+            type: import("../../index.js").CheckpointTypeEnum;
+            id: string;
+            location: string;
+            imageRef?: string | null | undefined;
+            reason?: string | null | undefined;
+        } | undefined;
+        workerQueueLength?: number | undefined;
+        image?: string | undefined;
+        placementTags?: {
+            key: string;
+            values?: string[] | undefined;
+        }[] | undefined;
+    }[]>>;
+    /** @deprecated Not currently used */
+    dequeueFromVersion(deploymentId: string, maxRunCount?: number, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
+        version: "1";
+        environment: {
+            type: "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
+            id: string;
+        };
+        organization: {
+            id: string;
+        };
+        project: {
+            id: string;
+        };
+        deployment: {
+            id?: string | undefined;
+            friendlyId?: string | undefined;
+            imagePlatform?: string | undefined;
+        };
+        run: {
+            id: string;
+            isTest: boolean;
+            machine: {
+                cpu: number;
+                memory: number;
+                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
+                centsPerMs: number;
+            };
+            traceContext: Record<string, unknown>;
+            friendlyId: string;
+            attemptNumber: number;
+            masterQueue: string;
+        };
+        snapshot: {
+            id: string;
+            createdAt: Date;
+            description: string;
+            friendlyId: string;
+            executionStatus: import("../../index.js").TaskRunExecutionStatus;
+        };
+        completedWaitpoints: {
+            type: import("../../index.js").WaitpointType;
+            id: string;
+            friendlyId: string;
+            completedAt: Date;
+            outputIsError: boolean;
+            idempotencyKey?: string | undefined;
+            output?: string | undefined;
+            outputType?: string | undefined;
+            index?: number | undefined;
+            completedByTaskRun?: {
+                id: string;
+                friendlyId: string;
+                batch?: {
+                    id: string;
+                    friendlyId: string;
+                } | undefined;
+            } | undefined;
+            completedAfter?: Date | undefined;
+            completedByBatch?: {
+                id: string;
+                friendlyId: string;
+            } | undefined;
+        }[];
+        dequeuedAt: Date;
+        backgroundWorker: {
+            id: string;
+            version: string;
+            friendlyId: string;
+        };
+        checkpoint?: {
+            type: import("../../index.js").CheckpointTypeEnum;
+            id: string;
+            location: string;
+            imageRef?: string | null | undefined;
+            reason?: string | null | undefined;
+        } | undefined;
+        workerQueueLength?: number | undefined;
+        image?: string | undefined;
+        placementTags?: {
+            key: string;
+            values?: string[] | undefined;
+        }[] | undefined;
+    }[]>>;
+    heartbeatWorker(body: WorkerApiHeartbeatRequestBody): Promise<import("../../zodfetch.js").ApiResult<{
+        ok: true;
+    }>>;
+    heartbeatRun(runId: string, snapshotId: string, body: WorkerApiRunHeartbeatRequestBody, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
+        ok: true;
+    }>>;
+    startRunAttempt(runId: string, snapshotId: string, body: WorkerApiRunAttemptStartRequestBody, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
+        run: {
+            status: import("../../index.js").TaskRunStatus;
+            id: string;
+            friendlyId: string;
+            attemptNumber?: number | null | undefined;
+        };
+        snapshot: {
+            id: string;
+            createdAt: Date;
+            description: string;
+            friendlyId: string;
+            executionStatus: import("../../index.js").TaskRunExecutionStatus;
+        };
+    } & {
+        execution: {
+            task: {
+                id: string;
+                filePath: string;
+            } & {
+                [k: string]: unknown;
+            };
+            queue: {
+                name: string;
+                id: string;
+            };
+            environment: {
+                type: "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
+                id: string;
+                slug: string;
+                branchName?: string | undefined;
+                git?: {
+                    dirty?: boolean | undefined;
+                    source?: "trigger_github_app" | "github_actions" | "local" | undefined;
+                    provider?: string | undefined;
+                    ghUsername?: string | undefined;
+                    ghUserAvatarUrl?: string | undefined;
+                    commitAuthorName?: string | undefined;
+                    commitMessage?: string | undefined;
+                    commitRef?: string | undefined;
+                    commitSha?: string | undefined;
+                    remoteUrl?: string | undefined;
+                    pullRequestNumber?: number | undefined;
+                    pullRequestTitle?: string | undefined;
+                    pullRequestState?: "open" | "closed" | "merged" | undefined;
+                } | undefined;
+            };
+            organization: {
+                name: string;
+                id: string;
+                slug: string;
+            };
+            project: {
+                name: string;
+                id: string;
+                slug: string;
+                ref: string;
+            };
+            machine: {
+                cpu: number;
+                memory: number;
+                name: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x";
+                centsPerMs: number;
+            };
+            attempt: {
+                number: number;
+                startedAt: Date;
+            } & {
+                [k: string]: unknown;
+            };
+            run: {
+                payload: string;
+                id: string;
+                payloadType: string;
+                tags: string[];
+                isTest: boolean;
+                createdAt: Date;
+                startedAt: Date;
+                metadata?: Record<string, import("../../../index.js").DeserializedJson> | undefined;
+                idempotencyKey?: string | undefined;
+                maxAttempts?: number | undefined;
+                version?: string | undefined;
+                maxDuration?: number | undefined;
+                priority?: number | undefined;
+                baseCostInCents?: number | undefined;
+                parentTaskRunId?: string | undefined;
+                rootTaskRunId?: string | undefined;
+                durationMs?: number | undefined;
+                costInCents?: number | undefined;
+                region?: string | undefined;
+            } & {
+                traceContext?: Record<string, unknown> | undefined;
+            };
+            batch?: {
+                id: string;
+            } | undefined;
+            deployment?: {
+                id: string;
+                version: string;
+                shortCode: string;
+                runtime: string;
+                runtimeVersion: string;
+                git?: {
+                    dirty?: boolean | undefined;
+                    source?: "trigger_github_app" | "github_actions" | "local" | undefined;
+                    provider?: string | undefined;
+                    ghUsername?: string | undefined;
+                    ghUserAvatarUrl?: string | undefined;
+                    commitAuthorName?: string | undefined;
+                    commitMessage?: string | undefined;
+                    commitRef?: string | undefined;
+                    commitSha?: string | undefined;
+                    remoteUrl?: string | undefined;
+                    pullRequestNumber?: number | undefined;
+                    pullRequestTitle?: string | undefined;
+                    pullRequestState?: "open" | "closed" | "merged" | undefined;
+                } | undefined;
+            } | undefined;
+        };
+    } & {
+        envVars: Record<string, string>;
+    }>>;
+    completeRunAttempt(runId: string, snapshotId: string, body: WorkerApiRunAttemptCompleteRequestBody, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
+        result: {
+            attemptStatus: "RUN_FINISHED" | "RUN_PENDING_CANCEL" | "RETRY_QUEUED" | "RETRY_IMMEDIATELY";
+        } & {
+            run: {
+                status: import("../../index.js").TaskRunStatus;
+                id: string;
+                friendlyId: string;
+                attemptNumber?: number | null | undefined;
+            };
+            snapshot: {
+                id: string;
+                createdAt: Date;
+                description: string;
+                friendlyId: string;
+                executionStatus: import("../../index.js").TaskRunExecutionStatus;
+            };
+        };
+    }>>;
+    getLatestSnapshot(runId: string, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
+        execution: {
+            version: "1";
+            run: {
+                status: import("../../index.js").TaskRunStatus;
+                id: string;
+                friendlyId: string;
+                attemptNumber?: number | null | undefined;
+            };
+            snapshot: {
+                id: string;
+                createdAt: Date;
+                description: string;
+                friendlyId: string;
+                executionStatus: import("../../index.js").TaskRunExecutionStatus;
+            };
+            completedWaitpoints: {
+                type: import("../../index.js").WaitpointType;
+                id: string;
+                friendlyId: string;
+                completedAt: Date;
+                outputIsError: boolean;
+                idempotencyKey?: string | undefined;
+                output?: string | undefined;
+                outputType?: string | undefined;
+                index?: number | undefined;
+                completedByTaskRun?: {
+                    id: string;
+                    friendlyId: string;
+                    batch?: {
+                        id: string;
+                        friendlyId: string;
+                    } | undefined;
+                } | undefined;
+                completedAfter?: Date | undefined;
+                completedByBatch?: {
+                    id: string;
+                    friendlyId: string;
+                } | undefined;
+            }[];
+            batch?: {
+                id: string;
+                friendlyId: string;
+            } | undefined;
+            checkpoint?: {
+                type: import("../../index.js").CheckpointTypeEnum;
+                id: string;
+                friendlyId: string;
+                location: string;
+                imageRef?: string | null | undefined;
+                reason?: string | null | undefined;
+            } | undefined;
+        };
+    }>>;
+    getSnapshotsSince(runId: string, snapshotId: string, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
+        snapshots: {
+            version: "1";
+            run: {
+                status: import("../../index.js").TaskRunStatus;
+                id: string;
+                friendlyId: string;
+                attemptNumber?: number | null | undefined;
+            };
+            snapshot: {
+                id: string;
+                createdAt: Date;
+                description: string;
+                friendlyId: string;
+                executionStatus: import("../../index.js").TaskRunExecutionStatus;
+            };
+            completedWaitpoints: {
+                type: import("../../index.js").WaitpointType;
+                id: string;
+                friendlyId: string;
+                completedAt: Date;
+                outputIsError: boolean;
+                idempotencyKey?: string | undefined;
+                output?: string | undefined;
+                outputType?: string | undefined;
+                index?: number | undefined;
+                completedByTaskRun?: {
+                    id: string;
+                    friendlyId: string;
+                    batch?: {
+                        id: string;
+                        friendlyId: string;
+                    } | undefined;
+                } | undefined;
+                completedAfter?: Date | undefined;
+                completedByBatch?: {
+                    id: string;
+                    friendlyId: string;
+                } | undefined;
+            }[];
+            batch?: {
+                id: string;
+                friendlyId: string;
+            } | undefined;
+            checkpoint?: {
+                type: import("../../index.js").CheckpointTypeEnum;
+                id: string;
+                friendlyId: string;
+                location: string;
+                imageRef?: string | null | undefined;
+                reason?: string | null | undefined;
+            } | undefined;
+        }[];
+    }>>;
+    sendDebugLog(runId: string, body: WorkerApiDebugLogBody, runnerId?: string): Promise<void>;
+    continueRunExecution(runId: string, snapshotId: string, runnerId?: string): Promise<import("../../zodfetch.js").ApiResult<{
+        run: {
+            status: import("../../index.js").TaskRunStatus;
+            id: string;
+            friendlyId: string;
+            attemptNumber?: number | null | undefined;
+        };
+        snapshot: {
+            id: string;
+            createdAt: Date;
+            description: string;
+            friendlyId: string;
+            executionStatus: import("../../index.js").TaskRunExecutionStatus;
+        };
+    }>>;
+    submitSuspendCompletion({ runId, snapshotId, runnerId, body, }: {
+        runId: string;
+        snapshotId: string;
+        runnerId?: string;
+        body: WorkerApiSuspendRunRequestBody;
+    }): Promise<import("../../zodfetch.js").ApiResult<{
+        ok: true;
+    }>>;
+    private runnerIdHeader;
+}
+export {};