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

package/dist/commonjs/v3/runEngineWorker/workerQueue.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WeightedWorkerQueueSubscriptions = exports.WeightedWorkerQueueSubscription = exports.WorkerQueueSubscriptions = exports.MAX_WORKER_QUEUE_SUBSCRIPTIONS = exports.WorkerQueueSubscription = exports.WorkerQueueChannel = exports.WorkerQueueCompatibility = exports.WorkerQueuePhase = exports.WorkerQueueDispatchClass = exports.SCHEDULED_WORKER_QUEUE_SUFFIX = exports.WORKER_QUEUE_VERSION = void 0;
+exports.isV2WorkerQueue = isV2WorkerQueue;
+exports.parseWorkerQueue = parseWorkerQueue;
+exports.formatWorkerQueue = formatWorkerQueue;
+exports.legacyScheduledWorkerQueue = legacyScheduledWorkerQueue;
+exports.restoreWorkerQueue = restoreWorkerQueue;
+exports.scheduledWorkerQueue = scheduledWorkerQueue;
+const v4_1 = require("zod/v4");
+exports.WORKER_QUEUE_VERSION = "v2";
+exports.SCHEDULED_WORKER_QUEUE_SUFFIX = ":scheduled";
+/** The dispatch class of a v2 worker queue. Kept separate from the legacy dequeue class. */
+exports.WorkerQueueDispatchClass = v4_1.z.enum(["ondemand", "scheduled"]);
+exports.WorkerQueuePhase = v4_1.z.enum(["fresh", "restore"]);
+exports.WorkerQueueCompatibility = v4_1.z.enum(["any", "container", "compute"]);
+exports.WorkerQueueChannel = v4_1.z.enum(["stable", "canary"]);
+exports.WorkerQueueSubscription = v4_1.z.strictObject({
+    class: exports.WorkerQueueDispatchClass,
+    phase: exports.WorkerQueuePhase,
+    compat: exports.WorkerQueueCompatibility,
+    channel: exports.WorkerQueueChannel,
+});
+exports.MAX_WORKER_QUEUE_SUBSCRIPTIONS = exports.WorkerQueueDispatchClass.options.length *
+    exports.WorkerQueuePhase.options.length *
+    exports.WorkerQueueCompatibility.options.length *
+    exports.WorkerQueueChannel.options.length;
+exports.WorkerQueueSubscriptions = v4_1.z
+    .array(exports.WorkerQueueSubscription)
+    .min(1)
+    .max(exports.MAX_WORKER_QUEUE_SUBSCRIPTIONS);
+exports.WeightedWorkerQueueSubscription = exports.WorkerQueueSubscription.extend({
+    weight: v4_1.z.number().finite().min(0).max(1).optional(),
+});
+function subscriptionKey(subscription) {
+    return `${subscription.class}:${subscription.phase}:${subscription.compat}:${subscription.channel}`;
+}
+exports.WeightedWorkerQueueSubscriptions = v4_1.z
+    .array(exports.WeightedWorkerQueueSubscription)
+    .min(1)
+    .max(exports.MAX_WORKER_QUEUE_SUBSCRIPTIONS)
+    .superRefine((subscriptions, ctx) => {
+    const identities = new Set();
+    let hasPositiveWeight = false;
+    for (const [index, subscription] of subscriptions.entries()) {
+        const key = subscriptionKey(subscription);
+        if (identities.has(key)) {
+            ctx.addIssue({
+                code: "custom",
+                message: "Worker queue subscriptions must have unique identities",
+                path: [index],
+            });
+        }
+        identities.add(key);
+        hasPositiveWeight ||= (subscription.weight ?? 1) > 0;
+    }
+    if (!hasPositiveWeight) {
+        ctx.addIssue({
+            code: "custom",
+            message: "At least one worker queue subscription must have a positive weight",
+        });
+    }
+});
+const WorkerQueueRegion = v4_1.z.string().regex(/^[^:\s]+$/);
+function isV2WorkerQueue(name) {
+    return name.split(":")[1] === exports.WORKER_QUEUE_VERSION;
+}
+function parseWorkerQueue(name) {
+    const [rawRegion, versionOrClass, queueClass, phase, compat, channel, ...extra] = name.split(":");
+    const region = WorkerQueueRegion.parse(rawRegion);
+    if (versionOrClass === undefined) {
+        return { region, version: "legacy", class: "ondemand" };
+    }
+    if (versionOrClass === "scheduled" && queueClass === undefined) {
+        return { region, version: "legacy", class: "scheduled" };
+    }
+    if (versionOrClass !== exports.WORKER_QUEUE_VERSION || extra.length > 0) {
+        throw new Error(`Invalid worker queue name: ${name}`);
+    }
+    const subscription = exports.WorkerQueueSubscription.parse({
+        class: queueClass,
+        phase,
+        compat,
+        channel,
+    });
+    return { region, version: exports.WORKER_QUEUE_VERSION, ...subscription };
+}
+function formatWorkerQueue(queue) {
+    const region = WorkerQueueRegion.parse(queue.region);
+    if (queue.version === "legacy") {
+        return queue.class === "scheduled" ? `${region}${exports.SCHEDULED_WORKER_QUEUE_SUFFIX}` : region;
+    }
+    const subscription = exports.WorkerQueueSubscription.parse({
+        class: queue.class,
+        phase: queue.phase,
+        compat: queue.compat,
+        channel: queue.channel,
+    });
+    const { class: queueClass, phase, compat, channel } = subscription;
+    return `${region}:${exports.WORKER_QUEUE_VERSION}:${queueClass}:${phase}:${compat}:${channel}`;
+}
+function legacyScheduledWorkerQueue(name) {
+    return name.endsWith(exports.SCHEDULED_WORKER_QUEUE_SUFFIX)
+        ? name
+        : `${name}${exports.SCHEDULED_WORKER_QUEUE_SUFFIX}`;
+}
+function restoreWorkerQueue(name, compat) {
+    if (!isV2WorkerQueue(name)) {
+        return name;
+    }
+    const queue = parseWorkerQueue(name);
+    if (queue.version === "legacy") {
+        return name;
+    }
+    return formatWorkerQueue({ ...queue, phase: "restore", compat });
+}
+function scheduledWorkerQueue(name) {
+    const queue = parseWorkerQueue(name);
+    return formatWorkerQueue({ ...queue, class: "scheduled" });
+}
+//# sourceMappingURL=workerQueue.js.map

package/dist/commonjs/v3/runEngineWorker/workerQueue.js.map

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

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

@@ -0,0 +1,262 @@
+import type { WorkloadHeartbeatRequestBody, WorkloadRunAttemptCompleteRequestBody, WorkloadRunAttemptStartRequestBody, WorkloadDebugLogRequestBody } from "./schemas.js";
+import type { WorkloadClientCommonOptions } from "./types.js";
+type WorkloadHttpClientOptions = WorkloadClientCommonOptions;
+export declare class WorkloadHttpClient {
+    private opts;
+    private apiUrl;
+    private runnerId;
+    constructor(opts: WorkloadHttpClientOptions);
+    updateApiUrl(apiUrl: string): void;
+    updateRunnerId(runnerId: string): void;
+    defaultHeaders(): Record<string, string>;
+    private isConnectionError;
+    private withConnectionErrorDetection;
+    heartbeatRun(runId: string, snapshotId: string, body?: WorkloadHeartbeatRequestBody): Promise<{
+        success: true;
+        data: {
+            ok: true;
+        };
+    } | {
+        success: false;
+        error: string;
+        isConnectionError?: boolean;
+    }>;
+    suspendRun(runId: string, snapshotId: string): Promise<import("../../zodfetch.js").ApiResult<{
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    }>>;
+    continueRunExecution(runId: string, snapshotId: string): Promise<{
+        success: true;
+        data: {
+            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;
+            };
+        };
+    } | {
+        success: false;
+        error: string;
+        isConnectionError?: boolean;
+    }>;
+    startRunAttempt(runId: string, snapshotId: string, body: WorkloadRunAttemptStartRequestBody): Promise<import("../../zodfetch.js").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: WorkloadRunAttemptCompleteRequestBody): Promise<import("../../zodfetch.js").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;
+            };
+        };
+    }>>;
+    getSnapshotsSince(runId: string, snapshotId: string): Promise<{
+        success: true;
+        data: {
+            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;
+                }[];
+            }[];
+        };
+    } | {
+        success: false;
+        error: string;
+        isConnectionError?: boolean;
+    }>;
+    sendDebugLog(runId: string, body: WorkloadDebugLogRequestBody): Promise<void>;
+}
+export {};

package/dist/commonjs/v3/runEngineWorker/workload/http.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkloadHttpClient = void 0;
+const v4_1 = require("zod/v4");
+const schemas_js_1 = require("./schemas.js");
+const util_js_1 = require("./util.js");
+const zodfetch_js_1 = require("../../zodfetch.js");
+class WorkloadHttpClient {
+    opts;
+    apiUrl;
+    runnerId;
+    constructor(opts) {
+        this.opts = opts;
+        this.apiUrl = opts.workerApiUrl.replace(/\/$/, "");
+        this.runnerId = opts.runnerId;
+        if (!this.apiUrl) {
+            throw new Error("apiURL is required and needs to be a non-empty string");
+        }
+        if (!opts.deploymentId) {
+            throw new Error("deploymentId is required and needs to be a non-empty string");
+        }
+    }
+    updateApiUrl(apiUrl) {
+        this.apiUrl = apiUrl.replace(/\/$/, "");
+    }
+    updateRunnerId(runnerId) {
+        this.runnerId = runnerId;
+    }
+    defaultHeaders() {
+        return (0, util_js_1.getDefaultWorkloadHeaders)({
+            ...this.opts,
+            runnerId: this.runnerId,
+        });
+    }
+    isConnectionError(error) {
+        const connectionErrors = [
+            "Connection error",
+            "ECONNREFUSED",
+            "ETIMEDOUT",
+            "ENOTFOUND",
+            "ECONNRESET",
+            "EHOSTUNREACH",
+            "ENETUNREACH",
+            "EPIPE",
+            "ECONNABORTED",
+        ];
+        return connectionErrors.some((errType) => error.includes(errType));
+    }
+    async withConnectionErrorDetection(operation) {
+        const result = await operation();
+        if (result.success) {
+            return result;
+        }
+        // Check if this is a connection error
+        if (this.isConnectionError(result.error)) {
+            return {
+                ...result,
+                isConnectionError: true,
+            };
+        }
+        return result;
+    }
+    async heartbeatRun(runId, snapshotId, body) {
+        return this.withConnectionErrorDetection(() => (0, zodfetch_js_1.wrapZodFetch)(schemas_js_1.WorkloadHeartbeatResponseBody, `${this.apiUrl}/api/v1/workload-actions/runs/${runId}/snapshots/${snapshotId}/heartbeat`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders(),
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body ?? {}),
+            signal: AbortSignal.timeout(10_000), // 10 second timeout
+        }));
+    }
+    async suspendRun(runId, snapshotId) {
+        return (0, zodfetch_js_1.wrapZodFetch)(schemas_js_1.WorkloadSuspendRunResponseBody, `${this.apiUrl}/api/v1/workload-actions/runs/${runId}/snapshots/${snapshotId}/suspend`, {
+            method: "GET",
+            headers: {
+                ...this.defaultHeaders(),
+            },
+        });
+    }
+    async continueRunExecution(runId, snapshotId) {
+        return this.withConnectionErrorDetection(() => (0, zodfetch_js_1.wrapZodFetch)(schemas_js_1.WorkloadContinueRunExecutionResponseBody, `${this.apiUrl}/api/v1/workload-actions/runs/${runId}/snapshots/${snapshotId}/continue`, {
+            method: "GET",
+            headers: {
+                ...this.defaultHeaders(),
+            },
+        }, {
+            // This hop only reaches the supervisor's workload server, so retry
+            // generously with jittered backoff to ride out a transient blip
+            // talking to the supervisor (e.g. a restart) rather than aborting the
+            // run. Database outages surface one hop further in, on the
+            // supervisor-to-engine call, which carries its own retry for them.
+            retry: {
+                minTimeoutInMs: 500,
+                maxTimeoutInMs: 10_000,
+                maxAttempts: 8,
+                factor: 2,
+                randomize: true,
+            },
+        }));
+    }
+    async startRunAttempt(runId, snapshotId, body) {
+        return (0, zodfetch_js_1.wrapZodFetch)(schemas_js_1.WorkloadRunAttemptStartResponseBody, `${this.apiUrl}/api/v1/workload-actions/runs/${runId}/snapshots/${snapshotId}/attempts/start`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders(),
+            },
+            body: JSON.stringify(body),
+        }, {
+            retry: {
+                minTimeoutInMs: 1000,
+                maxTimeoutInMs: 10_000,
+                maxAttempts: 6,
+                factor: 2,
+                randomize: true,
+            },
+        });
+    }
+    async completeRunAttempt(runId, snapshotId, body) {
+        return (0, zodfetch_js_1.wrapZodFetch)(schemas_js_1.WorkloadRunAttemptCompleteResponseBody, `${this.apiUrl}/api/v1/workload-actions/runs/${runId}/snapshots/${snapshotId}/attempts/complete`, {
+            method: "POST",
+            headers: {
+                ...this.defaultHeaders(),
+            },
+            body: JSON.stringify(body),
+        });
+    }
+    async getSnapshotsSince(runId, snapshotId) {
+        return this.withConnectionErrorDetection(() => (0, zodfetch_js_1.wrapZodFetch)(schemas_js_1.WorkloadRunSnapshotsSinceResponseBody, `${this.apiUrl}/api/v1/workload-actions/runs/${runId}/snapshots/since/${snapshotId}`, {
+            method: "GET",
+            headers: {
+                ...this.defaultHeaders(),
+            },
+            signal: AbortSignal.timeout(10_000), // 10 second timeout
+        }));
+    }
+    async sendDebugLog(runId, body) {
+        try {
+            const res = await (0, zodfetch_js_1.wrapZodFetch)(v4_1.z.unknown(), `${this.apiUrl}/api/v1/workload-actions/runs/${runId}/logs/debug`, {
+                method: "POST",
+                headers: {
+                    ...this.defaultHeaders(),
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+            });
+            if (!res.success) {
+                console.error("Failed to send debug log", res);
+            }
+        }
+        catch (error) {
+            console.error("Failed to send debug log", { error });
+        }
+    }
+}
+exports.WorkloadHttpClient = WorkloadHttpClient;
+//# sourceMappingURL=http.js.map

package/dist/commonjs/v3/runEngineWorker/workload/http.js.map

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