@trigger.dev/core 0.0.0-buffer-fix-20231206151546 → 0.0.0-bun-prerelease-20260909132648

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

@@ -0,0 +1,153 @@
+import { Counter, Gauge, Histogram, Registry } from "prom-client";
+export class ConsumerPoolMetrics {
+    register;
+    prefix;
+    // Current state metrics
+    consumerCount;
+    queueLength;
+    smoothedQueueLength;
+    targetConsumerCount;
+    scalingStrategy;
+    // Scaling operation metrics
+    scalingOperationsTotal;
+    consumersAddedTotal;
+    consumersRemovedTotal;
+    scalingCooldownsApplied;
+    // Performance metrics
+    queueLengthUpdatesTotal;
+    batchesProcessedTotal;
+    // Dequeue API latency (client-side, measured around the dequeue HTTP call)
+    dequeueDurationSeconds;
+    constructor(opts = {}) {
+        this.register = opts.register ?? new Registry();
+        this.prefix = opts.prefix ?? "queue_consumer_pool";
+        // Current state metrics
+        this.consumerCount = new Gauge({
+            name: `${this.prefix}_consumer_count`,
+            help: "Current number of active queue consumers",
+            labelNames: ["strategy"],
+            registers: [this.register],
+        });
+        this.queueLength = new Gauge({
+            name: `${this.prefix}_queue_length`,
+            help: "Current queue length (median of recent samples)",
+            registers: [this.register],
+        });
+        this.smoothedQueueLength = new Gauge({
+            name: `${this.prefix}_smoothed_queue_length`,
+            help: "EWMA smoothed queue length",
+            registers: [this.register],
+        });
+        this.targetConsumerCount = new Gauge({
+            name: `${this.prefix}_target_consumer_count`,
+            help: "Target number of consumers calculated by scaling strategy",
+            labelNames: ["strategy"],
+            registers: [this.register],
+        });
+        this.scalingStrategy = new 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 Counter({
+            name: `${this.prefix}_scaling_operations_total`,
+            help: "Total number of scaling operations performed",
+            labelNames: ["direction", "strategy"],
+            registers: [this.register],
+        });
+        this.consumersAddedTotal = new Counter({
+            name: `${this.prefix}_consumers_added_total`,
+            help: "Total number of consumers added",
+            registers: [this.register],
+        });
+        this.consumersRemovedTotal = new Counter({
+            name: `${this.prefix}_consumers_removed_total`,
+            help: "Total number of consumers removed",
+            registers: [this.register],
+        });
+        this.scalingCooldownsApplied = new 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 Counter({
+            name: `${this.prefix}_queue_length_updates_total`,
+            help: "Total number of queue length updates received",
+            registers: [this.register],
+        });
+        this.batchesProcessedTotal = new Counter({
+            name: `${this.prefix}_batches_processed_total`,
+            help: "Total number of metric batches processed",
+            registers: [this.register],
+        });
+        this.dequeueDurationSeconds = new Histogram({
+            name: `${this.prefix}_dequeue_duration_seconds`,
+            help: "Client-side duration of the dequeue API call (POST /engine/v1/worker-actions/dequeue), including the HTTP client's internal retries and backoff",
+            labelNames: ["outcome"],
+            // The HTTP client retries internally (up to 5 attempts with 0.5-5s backoff),
+            // so one observation can span multiple requests plus sleeps. A retryable
+            // failure surfaces as `error` only after >=7.5s of backoff - the 10-30s
+            // buckets exist so that mode doesn't collapse into +Inf. The server also
+            // long-polls (RUN_ENGINE_DEQUEUE_BLOCKING_TIMEOUT_SECONDS, default 10s),
+            // parking empty dequeues at ~10s - the 11/12.5/15/20 buckets give the
+            // quantiles resolution just above that boundary, where the mass sits.
+            // 60s brackets the worst-case error envelope (5 attempts that each hit
+            // the ~10s hold, plus backoff); beyond that the connection is hung.
+            buckets: [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2, 5, 10, 11, 12.5, 15, 20, 30, 60],
+            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();
+    }
+    /**
+     * Record the client-side latency of a single dequeue API round-trip.
+     * @param seconds Wall-clock duration of the dequeue call, in seconds.
+     * @param outcome Whether the call returned runs, was empty, or errored.
+     */
+    observeDequeueLatency(seconds, outcome) {
+        this.dequeueDurationSeconds.observe({ outcome }, seconds);
+    }
+}
+//# sourceMappingURL=consumerPoolMetrics.js.map

package/dist/esm/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/esm/v3/runEngineWorker/supervisor/events.d.ts

@@ -0,0 +1,50 @@
+import type { TaskRunExecutionResult } from "../../schemas/common.js";
+import type { DequeuedMessage, StartRunAttemptResult } from "../../schemas/runEngine.js";
+export type WorkerEvents = {
+    runQueueMessage: [
+        {
+            time: Date;
+            message: DequeuedMessage;
+            dequeueResponseMs?: number;
+            pollingIntervalMs?: number;
+        }
+    ];
+    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;
+            };
+        }
+    ];
+};

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/esm/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/esm/v3/runEngineWorker/supervisor/http.d.ts

@@ -0,0 +1,404 @@
+import type { WorkerApiConnectRequestBody, WorkerApiDequeueRequestBody, WorkerApiHeartbeatRequestBody, WorkerApiRunAttemptCompleteRequestBody, WorkerApiRunAttemptStartRequestBody, WorkerApiRunHeartbeatRequestBody, WorkerApiDebugLogBody, WorkerApiSuspendRunRequestBody } from "./schemas.js";
+import type { SupervisorClientCommonOptions } from "./types.js";
+import { type ApiResult } from "../../zodfetch.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 onHttpRequestComplete?;
+    private readonly logger;
+    constructor(opts: SupervisorHttpClientOptions);
+    private request;
+    connect(body: WorkerApiConnectRequestBody): Promise<ApiResult<{
+        ok: true;
+        workerGroup: {
+            type: string;
+            name: string;
+        };
+    }>>;
+    dequeue(body: WorkerApiDequeueRequestBody): Promise<ApiResult<{
+        version: "1";
+        snapshot: {
+            id: string;
+            friendlyId: string;
+            executionStatus: "DELAYED" | "EXECUTING" | "EXECUTING_WITH_WAITPOINTS" | "FINISHED" | "PENDING_CANCEL" | "PENDING_EXECUTING" | "QUEUED" | "QUEUED_EXECUTING" | "RUN_CREATED" | "SUSPENDED";
+            description: string;
+            createdAt: Date;
+        };
+        dequeuedAt: Date;
+        workerQueueLength?: number | undefined;
+        image?: string | undefined;
+        checkpoint?: {
+            id: string;
+            type: "COMPUTE" | "DOCKER" | "KUBERNETES";
+            location: string;
+            imageRef?: string | null | undefined;
+            reason?: string | null | undefined;
+        } | undefined;
+        completedWaitpoints: {
+            id: string;
+            index?: number | undefined;
+            friendlyId: string;
+            type: "BATCH" | "DATETIME" | "MANUAL" | "RUN";
+            completedAt: Date;
+            idempotencyKey?: string | undefined;
+            completedByTaskRun?: {
+                id: string;
+                friendlyId: string;
+                batch?: {
+                    id: string;
+                    friendlyId: string;
+                } | undefined;
+            } | undefined;
+            completedAfter?: Date | undefined;
+            completedByBatch?: {
+                id: string;
+                friendlyId: string;
+            } | undefined;
+            output?: string | undefined;
+            outputType?: string | undefined;
+            outputIsError: boolean;
+        }[];
+        backgroundWorker: {
+            id: string;
+            friendlyId: string;
+            version: string;
+            runtime?: string | undefined;
+        };
+        deployment: {
+            id?: string | undefined;
+            friendlyId?: string | undefined;
+            imagePlatform?: string | undefined;
+        };
+        run: {
+            id: string;
+            friendlyId: string;
+            isTest: boolean;
+            isReplay: boolean;
+            machine: {
+                name: "large-1x" | "large-2x" | "medium-1x" | "medium-2x" | "micro" | "small-1x" | "small-2x";
+                cpu: number;
+                memory: number;
+                centsPerMs: number;
+            };
+            attemptNumber: number;
+            masterQueue: string;
+            traceContext: Record<string, unknown>;
+            annotations?: {
+                triggerSource: "api" | "cli" | "dashboard" | "mcp" | "schedule" | "sdk" | (string & {});
+                triggerAction: "replay" | "test" | "trigger" | (string & {});
+                rootTriggerSource: "api" | "cli" | "dashboard" | "mcp" | "schedule" | "sdk" | (string & {});
+                rootScheduleId?: string | undefined;
+                taskKind?: "AGENT" | "SCHEDULED" | "STANDARD" | (string & {}) | undefined;
+                externalDeploymentId?: string | undefined;
+            } | undefined;
+        };
+        environment: {
+            id: string;
+            type: "DEVELOPMENT" | "PREVIEW" | "PRODUCTION" | "STAGING";
+        };
+        organization: {
+            id: string;
+            hasPrivateLink?: boolean | undefined;
+        };
+        project: {
+            id: string;
+        };
+        placementTags?: {
+            key: string;
+            values?: string[] | undefined;
+        }[] | undefined;
+    }[]>>;
+    heartbeatWorker(body: WorkerApiHeartbeatRequestBody): Promise<ApiResult<{
+        ok: true;
+    }>>;
+    heartbeatRun(runId: string, snapshotId: string, body: WorkerApiRunHeartbeatRequestBody, runnerId?: string): Promise<ApiResult<{
+        ok: true;
+    }>>;
+    startRunAttempt(runId: string, snapshotId: string, body: WorkerApiRunAttemptStartRequestBody, runnerId?: string, environmentId?: string): Promise<ApiResult<{
+        snapshot: {
+            id: string;
+            friendlyId: string;
+            executionStatus: "DELAYED" | "EXECUTING" | "EXECUTING_WITH_WAITPOINTS" | "FINISHED" | "PENDING_CANCEL" | "PENDING_EXECUTING" | "QUEUED" | "QUEUED_EXECUTING" | "RUN_CREATED" | "SUSPENDED";
+            description: string;
+            createdAt: Date;
+        };
+        run: {
+            id: string;
+            friendlyId: string;
+            status: "CANCELED" | "COMPLETED_SUCCESSFULLY" | "COMPLETED_WITH_ERRORS" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "INTERRUPTED" | "PAUSED" | "PENDING" | "PENDING_VERSION" | "RETRYING_AFTER_FAILURE" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "WAITING_TO_RESUME";
+            attemptNumber?: number | null | undefined;
+            taskEventStore?: string | undefined;
+        };
+    } & {
+        execution: {
+            task: {
+                [x: string]: unknown;
+                id: string;
+                filePath: string;
+            };
+            queue: {
+                id: string;
+                name: string;
+            };
+            environment: {
+                id: string;
+                slug: string;
+                type: "DEVELOPMENT" | "PREVIEW" | "PRODUCTION" | "STAGING";
+                branchName?: string | undefined;
+                git?: {
+                    provider?: string | undefined;
+                    source?: "github_actions" | "local" | "trigger_github_app" | undefined;
+                    ghUsername?: string | undefined;
+                    ghUserAvatarUrl?: string | undefined;
+                    commitAuthorName?: string | undefined;
+                    commitMessage?: string | undefined;
+                    commitRef?: string | undefined;
+                    commitSha?: string | undefined;
+                    dirty?: boolean | undefined;
+                    remoteUrl?: string | undefined;
+                    pullRequestNumber?: number | undefined;
+                    pullRequestTitle?: string | undefined;
+                    pullRequestState?: "closed" | "merged" | "open" | undefined;
+                } | undefined;
+            };
+            organization: {
+                id: string;
+                slug: string;
+                name: string;
+            };
+            project: {
+                id: string;
+                ref: string;
+                slug: string;
+                name: string;
+            };
+            machine: {
+                name: "large-1x" | "large-2x" | "medium-1x" | "medium-2x" | "micro" | "small-1x" | "small-2x";
+                cpu: number;
+                memory: number;
+                centsPerMs: number;
+            };
+            batch?: {
+                id: string;
+            } | undefined;
+            deployment?: {
+                id: string;
+                shortCode: string;
+                version: string;
+                runtime: string;
+                runtimeVersion: string;
+                git?: {
+                    provider?: string | undefined;
+                    source?: "github_actions" | "local" | "trigger_github_app" | undefined;
+                    ghUsername?: string | undefined;
+                    ghUserAvatarUrl?: string | undefined;
+                    commitAuthorName?: string | undefined;
+                    commitMessage?: string | undefined;
+                    commitRef?: string | undefined;
+                    commitSha?: string | undefined;
+                    dirty?: boolean | undefined;
+                    remoteUrl?: string | undefined;
+                    pullRequestNumber?: number | undefined;
+                    pullRequestTitle?: string | undefined;
+                    pullRequestState?: "closed" | "merged" | "open" | undefined;
+                } | undefined;
+                externalId?: string | undefined;
+            } | undefined;
+            attempt: {
+                [x: string]: unknown;
+                number: number;
+                startedAt: Date;
+            };
+            run: {
+                id: string;
+                payload: string;
+                payloadType: string;
+                tags: string[];
+                isTest: boolean;
+                isReplay: boolean;
+                createdAt: Date;
+                startedAt: Date;
+                idempotencyKey?: string | undefined;
+                idempotencyKeyScope?: "attempt" | "global" | "run" | undefined;
+                maxAttempts?: number | undefined;
+                version?: string | undefined;
+                metadata?: Record<string, import("../../../index.js").DeserializedJson> | 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;
+                realtimeStreamsVersion?: string | undefined;
+            };
+        };
+    } & {
+        envVars: Record<string, string>;
+    }>>;
+    completeRunAttempt(runId: string, snapshotId: string, body: WorkerApiRunAttemptCompleteRequestBody, runnerId?: string, environmentId?: string): Promise<ApiResult<{
+        result: {
+            attemptStatus: "RETRY_IMMEDIATELY" | "RETRY_QUEUED" | "RUN_FINISHED" | "RUN_PENDING_CANCEL";
+        } & {
+            snapshot: {
+                id: string;
+                friendlyId: string;
+                executionStatus: "DELAYED" | "EXECUTING" | "EXECUTING_WITH_WAITPOINTS" | "FINISHED" | "PENDING_CANCEL" | "PENDING_EXECUTING" | "QUEUED" | "QUEUED_EXECUTING" | "RUN_CREATED" | "SUSPENDED";
+                description: string;
+                createdAt: Date;
+            };
+            run: {
+                id: string;
+                friendlyId: string;
+                status: "CANCELED" | "COMPLETED_SUCCESSFULLY" | "COMPLETED_WITH_ERRORS" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "INTERRUPTED" | "PAUSED" | "PENDING" | "PENDING_VERSION" | "RETRYING_AFTER_FAILURE" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "WAITING_TO_RESUME";
+                attemptNumber?: number | null | undefined;
+                taskEventStore?: string | undefined;
+            };
+        };
+    }>>;
+    getLatestSnapshot(runId: string, runnerId?: string, environmentId?: string): Promise<ApiResult<{
+        execution: {
+            version: "1";
+            snapshot: {
+                id: string;
+                friendlyId: string;
+                executionStatus: "DELAYED" | "EXECUTING" | "EXECUTING_WITH_WAITPOINTS" | "FINISHED" | "PENDING_CANCEL" | "PENDING_EXECUTING" | "QUEUED" | "QUEUED_EXECUTING" | "RUN_CREATED" | "SUSPENDED";
+                description: string;
+                createdAt: Date;
+            };
+            run: {
+                id: string;
+                friendlyId: string;
+                status: "CANCELED" | "COMPLETED_SUCCESSFULLY" | "COMPLETED_WITH_ERRORS" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "INTERRUPTED" | "PAUSED" | "PENDING" | "PENDING_VERSION" | "RETRYING_AFTER_FAILURE" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "WAITING_TO_RESUME";
+                attemptNumber?: number | null | undefined;
+                taskEventStore?: string | undefined;
+            };
+            batch?: {
+                id: string;
+                friendlyId: string;
+            } | undefined;
+            checkpoint?: {
+                type: "COMPUTE" | "DOCKER" | "KUBERNETES";
+                location: string;
+                imageRef?: string | null | undefined;
+                reason?: string | null | undefined;
+                id: string;
+                friendlyId: string;
+            } | undefined;
+            completedWaitpoints: {
+                id: string;
+                index?: number | undefined;
+                friendlyId: string;
+                type: "BATCH" | "DATETIME" | "MANUAL" | "RUN";
+                completedAt: Date;
+                idempotencyKey?: string | undefined;
+                completedByTaskRun?: {
+                    id: string;
+                    friendlyId: string;
+                    batch?: {
+                        id: string;
+                        friendlyId: string;
+                    } | undefined;
+                } | undefined;
+                completedAfter?: Date | undefined;
+                completedByBatch?: {
+                    id: string;
+                    friendlyId: string;
+                } | undefined;
+                output?: string | undefined;
+                outputType?: string | undefined;
+                outputIsError: boolean;
+            }[];
+        };
+    }>>;
+    getSnapshotsSince(runId: string, snapshotId: string, runnerId?: string, environmentId?: string): Promise<ApiResult<{
+        snapshots: {
+            version: "1";
+            snapshot: {
+                id: string;
+                friendlyId: string;
+                executionStatus: "DELAYED" | "EXECUTING" | "EXECUTING_WITH_WAITPOINTS" | "FINISHED" | "PENDING_CANCEL" | "PENDING_EXECUTING" | "QUEUED" | "QUEUED_EXECUTING" | "RUN_CREATED" | "SUSPENDED";
+                description: string;
+                createdAt: Date;
+            };
+            run: {
+                id: string;
+                friendlyId: string;
+                status: "CANCELED" | "COMPLETED_SUCCESSFULLY" | "COMPLETED_WITH_ERRORS" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "INTERRUPTED" | "PAUSED" | "PENDING" | "PENDING_VERSION" | "RETRYING_AFTER_FAILURE" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "WAITING_TO_RESUME";
+                attemptNumber?: number | null | undefined;
+                taskEventStore?: string | undefined;
+            };
+            batch?: {
+                id: string;
+                friendlyId: string;
+            } | undefined;
+            checkpoint?: {
+                type: "COMPUTE" | "DOCKER" | "KUBERNETES";
+                location: string;
+                imageRef?: string | null | undefined;
+                reason?: string | null | undefined;
+                id: string;
+                friendlyId: string;
+            } | undefined;
+            completedWaitpoints: {
+                id: string;
+                index?: number | undefined;
+                friendlyId: string;
+                type: "BATCH" | "DATETIME" | "MANUAL" | "RUN";
+                completedAt: Date;
+                idempotencyKey?: string | undefined;
+                completedByTaskRun?: {
+                    id: string;
+                    friendlyId: string;
+                    batch?: {
+                        id: string;
+                        friendlyId: string;
+                    } | undefined;
+                } | undefined;
+                completedAfter?: Date | undefined;
+                completedByBatch?: {
+                    id: string;
+                    friendlyId: string;
+                } | undefined;
+                output?: string | undefined;
+                outputType?: string | undefined;
+                outputIsError: boolean;
+            }[];
+        }[];
+    }>>;
+    sendDebugLog(runId: string, body: WorkerApiDebugLogBody, runnerId?: string): Promise<void>;
+    continueRunExecution(runId: string, snapshotId: string, runnerId?: string, environmentId?: string): Promise<ApiResult<{
+        snapshot: {
+            id: string;
+            friendlyId: string;
+            executionStatus: "DELAYED" | "EXECUTING" | "EXECUTING_WITH_WAITPOINTS" | "FINISHED" | "PENDING_CANCEL" | "PENDING_EXECUTING" | "QUEUED" | "QUEUED_EXECUTING" | "RUN_CREATED" | "SUSPENDED";
+            description: string;
+            createdAt: Date;
+        };
+        run: {
+            id: string;
+            friendlyId: string;
+            status: "CANCELED" | "COMPLETED_SUCCESSFULLY" | "COMPLETED_WITH_ERRORS" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "INTERRUPTED" | "PAUSED" | "PENDING" | "PENDING_VERSION" | "RETRYING_AFTER_FAILURE" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING_FOR_DEPLOY" | "WAITING_TO_RESUME";
+            attemptNumber?: number | null | undefined;
+            taskEventStore?: string | undefined;
+        };
+    }>>;
+    submitSuspendCompletion({ runId, snapshotId, runnerId, body, }: {
+        runId: string;
+        snapshotId: string;
+        runnerId?: string;
+        body: WorkerApiSuspendRunRequestBody;
+    }): Promise<ApiResult<{
+        ok: true;
+    }>>;
+    private runnerIdHeader;
+    private environmentIdHeader;
+}
+export {};