@trigger.dev/core 4.8.1 → 4.8.2

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

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkerApiRunSnapshotsSinceResponseBody = exports.WorkerApiSuspendCompletionResponseBody = exports.WorkerApiDebugLogBody = exports.WorkerApiDebugLogBodyInput = exports.DebugLogPropertiesInput = exports.DebugLogProperties = exports.DebugLogPropertiesValue = exports.WorkerApiRunLatestSnapshotResponseBody = exports.WorkerApiRunAttemptCompleteResponseBody = exports.WorkerApiRunAttemptCompleteRequestBody = exports.WorkerApiRunAttemptStartResponseBody = exports.WorkerApiRunAttemptStartRequestBody = exports.WorkerApiRunHeartbeatResponseBody = exports.WorkerApiRunHeartbeatRequestBody = exports.WorkerApiDequeueResponseBody = exports.WorkerApiDequeueRequestBody = exports.WorkerQueueClass = exports.WorkerApiConnectResponseBody = exports.WorkerApiConnectRequestBody = exports.WorkerApiRunRestoreOutcomeResponseBody = exports.WorkerApiRunRestoreOutcomeRequestBody = exports.WorkerApiContinueRunExecutionRequestBody = exports.WorkerApiSuspendRunResponseBody = exports.WorkerApiSuspendRunRequestBody = exports.WorkerApiHeartbeatResponseBody = exports.WorkerApiHeartbeatRequestBody = void 0;
+exports.WorkerApiRunSnapshotsSinceResponseBody = exports.WorkerApiSuspendCompletionResponseBody = exports.WorkerApiDebugLogBody = exports.WorkerApiDebugLogBodyInput = exports.DebugLogPropertiesInput = exports.DebugLogProperties = exports.DebugLogPropertiesValue = exports.WorkerApiRunLatestSnapshotResponseBody = exports.WorkerApiRunAttemptCompleteResponseBody = exports.WorkerApiRunAttemptCompleteRequestBody = exports.WorkerApiRunAttemptStartResponseBody = exports.WorkerApiRunAttemptStartRequestBody = exports.WorkerApiRunHeartbeatResponseBody = exports.WorkerApiRunHeartbeatRequestBody = exports.WorkerApiDequeueResponseBody = exports.WorkerApiDequeueRequestBody = exports.WorkerQueueClass = exports.WorkerApiConnectResponseBody = exports.WorkerApiConnectRequestBody = exports.WorkerApiRunReleaseResponseBody = exports.WorkerApiRunReleaseRequestBody = exports.WorkerApiRunRestoreOutcomeResponseBody = exports.WorkerApiRunRestoreOutcomeRequestBody = exports.WorkerApiContinueRunExecutionRequestBody = exports.WorkerApiSuspendRunResponseBody = exports.WorkerApiSuspendRunRequestBody = exports.WorkerApiHeartbeatResponseBody = exports.WorkerApiHeartbeatRequestBody = void 0;
 const v4_1 = require("zod/v4");
 const workerQueue_js_1 = require("../workerQueue.js");
 const zod_js_1 = require("../../utils/zod.js");
 const common_js_1 = require("../../schemas/common.js");
 const runEngine_js_1 = require("../../schemas/runEngine.js");
+const runTokenRefresh_js_1 = require("../runTokenRefresh.js");
 exports.WorkerApiHeartbeatRequestBody = v4_1.z.object({
     cpu: v4_1.z.object({
         used: v4_1.z.number(),
@@ -35,7 +36,8 @@ exports.WorkerApiSuspendRunResponseBody = v4_1.z.object({
 });
 exports.WorkerApiContinueRunExecutionRequestBody = runEngine_js_1.ExecutionResult;
 exports.WorkerApiRunRestoreOutcomeRequestBody = v4_1.z.object({
-    outcome: v4_1.z.enum(["requeue", "fail"]),
+    // `fallback` requeues a run that has not started onto the worker queue the platform falls back to.
+    outcome: v4_1.z.enum(["requeue", "fail", "fallback"]),
     reason: v4_1.z.string().max(256),
     // Matches the cap the engine applies to a run error's message.
     message: v4_1.z
@@ -46,6 +48,14 @@ exports.WorkerApiRunRestoreOutcomeRequestBody = v4_1.z.object({
 exports.WorkerApiRunRestoreOutcomeResponseBody = v4_1.z.object({
     ok: v4_1.z.literal(true),
 });
+exports.WorkerApiRunReleaseRequestBody = v4_1.z.object({
+    reason: v4_1.z.string().min(1).max(256),
+});
+exports.WorkerApiRunReleaseResponseBody = v4_1.z.object({
+    ok: v4_1.z.literal(true),
+    // False when the run could not be requeued, as when its dequeue budget is used up, so it failed.
+    requeued: v4_1.z.boolean(),
+});
 exports.WorkerApiConnectRequestBody = v4_1.z.object({
     metadata: v4_1.z.record(v4_1.z.string(), v4_1.z.any()),
 });
@@ -73,15 +83,21 @@ exports.WorkerApiDequeueResponseBody = runEngine_js_1.DequeuedMessage.array();
 exports.WorkerApiRunHeartbeatRequestBody = v4_1.z.object({
     cpu: v4_1.z.number().optional(),
     memory: v4_1.z.number().optional(),
+    // A malformed report must never fail the heartbeat itself.
+    runToken: runTokenRefresh_js_1.RunTokenHeartbeatReport.optional().catch(undefined),
 });
 exports.WorkerApiRunHeartbeatResponseBody = v4_1.z.object({
     ok: v4_1.z.literal(true),
+    /** A replacement TRIGGER_RUN_TOKEN, only when the runner's reported token is due for refresh. */
+    runToken: v4_1.z.string().optional(),
 });
 exports.WorkerApiRunAttemptStartRequestBody = v4_1.z.object({
     isWarmStart: v4_1.z.boolean().optional(),
     // Set by the supervisor, not the runner. A value this webapp cannot accept drops the stamp, never the attempt.
     workerCell: v4_1.z.string().max(64).optional().catch(undefined),
     workerLane: v4_1.z.string().max(32).optional().catch(undefined),
+    /** Set by runners that report and install run-token refreshes, so the attempt can get a short-lived token. */
+    supportsRunTokenRefresh: v4_1.z.boolean().optional().catch(undefined),
 });
 exports.WorkerApiRunAttemptStartResponseBody = runEngine_js_1.StartRunAttemptResult.and(v4_1.z.object({
     envVars: v4_1.z.record(v4_1.z.string(), v4_1.z.string()),

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

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

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

@@ -29,6 +29,9 @@ export declare class SupervisorSession extends EventEmitter<WorkerEvents> {
     private readonly logger;
     private readonly runNotificationsEnabled;
     private runNotificationsSocket?;
+    /** The runs subscribed to, asked for again on every connection: the platform keeps subscriptions per connection. */
+    private readonly runSubscriptions;
+    private reconnectDelayMs;
     private readonly queueConsumerEnabled;
     private readonly consumerPool;
     private readonly heartbeat;
@@ -36,7 +39,10 @@ export declare class SupervisorSession extends EventEmitter<WorkerEvents> {
     private onDequeue;
     subscribeToRunNotifications(runFriendlyIds: string[]): void;
     unsubscribeFromRunNotifications(runFriendlyIds: string[]): void;
+    private subscribe;
     private createRunNotificationsSocket;
+    /** socket.io stops after the platform rejects a handshake or disconnects the socket; the session does not. */
+    private reconnectIfGivenUp;
     start(): Promise<void>;
     stop(): Promise<void>;
     private getHeartbeatBody;

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

@@ -12,12 +12,17 @@ const socket_io_client_1 = require("socket.io-client");
 const util_js_1 = require("./util.js");
 const interval_js_1 = require("../../utils/interval.js");
 const structuredLogger_js_1 = require("../../utils/structuredLogger.js");
+const RECONNECT_DELAY_MS = 1_000;
+const RECONNECT_DELAY_MAX_MS = 30_000;
 class SupervisorSession extends events_1.default {
     opts;
     httpClient;
     logger = new structuredLogger_js_1.SimpleStructuredLogger("supervisor-session");
     runNotificationsEnabled;
     runNotificationsSocket;
+    /** The runs subscribed to, asked for again on every connection: the platform keeps subscriptions per connection. */
+    runSubscriptions = new Set();
+    reconnectDelayMs = RECONNECT_DELAY_MS;
     queueConsumerEnabled;
     consumerPool;
     heartbeat;
@@ -70,11 +75,14 @@ class SupervisorSession extends events_1.default {
     }
     subscribeToRunNotifications(runFriendlyIds) {
         this.logger.debug("Subscribing to run notifications", { runFriendlyIds });
-        if (!this.runNotificationsSocket) {
-            this.logger.error("Socket not connected");
+        for (const runFriendlyId of runFriendlyIds) {
+            this.runSubscriptions.add(runFriendlyId);
+        }
+        // Not connected, the connect handler asks for the whole set; asking here too would ask twice.
+        if (!this.runNotificationsSocket?.connected) {
             return;
         }
-        this.runNotificationsSocket.emit("run:subscribe", { version: "1", runFriendlyIds });
+        this.subscribe(this.runNotificationsSocket, runFriendlyIds);
         Promise.allSettled(runFriendlyIds.map((runFriendlyId) => this.httpClient.sendDebugLog(runFriendlyId, {
             time: new Date(),
             message: "run:subscribe supervisor -> platform",
@@ -82,8 +90,10 @@ class SupervisorSession extends events_1.default {
     }
     unsubscribeFromRunNotifications(runFriendlyIds) {
         this.logger.debug("Unsubscribing from run notifications", { runFriendlyIds });
-        if (!this.runNotificationsSocket) {
-            this.logger.error("Socket not connected");
+        for (const runFriendlyId of runFriendlyIds) {
+            this.runSubscriptions.delete(runFriendlyId);
+        }
+        if (!this.runNotificationsSocket?.connected) {
             return;
         }
         this.runNotificationsSocket.emit("run:unsubscribe", { version: "1", runFriendlyIds });
@@ -95,6 +105,9 @@ class SupervisorSession extends events_1.default {
             },
         })));
     }
+    subscribe(socket, runFriendlyIds) {
+        socket.emit("run:subscribe", { version: "1", runFriendlyIds });
+    }
     createRunNotificationsSocket() {
         const wsUrl = new URL(this.opts.apiUrl);
         wsUrl.pathname = "/worker";
@@ -112,15 +125,38 @@ class SupervisorSession extends events_1.default {
         });
         socket.on("connect", () => {
             this.logger.log("[WS] Connected to platform");
+            this.reconnectDelayMs = RECONNECT_DELAY_MS;
+            if (this.runSubscriptions.size > 0) {
+                this.logger.log("[WS] Subscribing to run notifications on connect", {
+                    runs: this.runSubscriptions.size,
+                });
+                this.subscribe(socket, [...this.runSubscriptions]);
+            }
         });
         socket.on("connect_error", (error) => {
             this.logger.error("[WS] Connection error", { error });
+            this.reconnectIfGivenUp(socket);
         });
         socket.on("disconnect", (reason, description) => {
             this.logger.log("[WS] Disconnected from platform", { reason, description });
+            this.reconnectIfGivenUp(socket);
         });
         return socket;
     }
+    /** socket.io stops after the platform rejects a handshake or disconnects the socket; the session does not. */
+    reconnectIfGivenUp(socket) {
+        if (socket.active || this.runNotificationsSocket !== socket) {
+            return;
+        }
+        const delayMs = this.reconnectDelayMs;
+        this.reconnectDelayMs = Math.min(delayMs * 2, RECONNECT_DELAY_MAX_MS);
+        this.logger.log("[WS] Connecting to platform again", { delayMs });
+        setTimeout(() => {
+            if (this.runNotificationsSocket === socket) {
+                socket.connect();
+            }
+        }, delayMs).unref();
+    }
     async start() {
         const connect = await this.httpClient.connect({
             metadata: {
@@ -160,7 +196,9 @@ class SupervisorSession extends events_1.default {
     async stop() {
         await this.consumerPool.stop();
         this.heartbeat.stop();
-        this.runNotificationsSocket?.disconnect();
+        const socket = this.runNotificationsSocket;
+        this.runNotificationsSocket = undefined;
+        socket?.disconnect();
     }
     getHeartbeatBody() {
         return {

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

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

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

@@ -15,6 +15,7 @@ export declare class WorkloadHttpClient {
         success: true;
         data: {
             ok: true;
+            runToken?: string | undefined;
         };
     } | {
         success: false;

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

@@ -2,10 +2,40 @@ import { z } from "zod/v4";
 export declare const WorkloadHeartbeatRequestBody: z.ZodObject<{
     cpu: z.ZodOptional<z.ZodNumber>;
     memory: z.ZodOptional<z.ZodNumber>;
+    runToken: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        expiresAt: z.ZodNumber;
+        trigger: z.ZodCatch<z.ZodEnum<{
+            heartbeat: "heartbeat";
+            restore: "restore";
+        }>>;
+        installation: z.ZodCatch<z.ZodOptional<import("../../utils/zod.js").CompatibleZodDiscriminatedUnion<readonly [z.ZodObject<{
+            result: z.ZodLiteral<"success">;
+            trigger: z.ZodCatch<z.ZodEnum<{
+                heartbeat: "heartbeat";
+                restore: "restore";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            result: z.ZodLiteral<"failure">;
+            reason: z.ZodCatch<z.ZodEnum<{
+                ack_timeout: "ack_timeout";
+                identity_mismatch: "identity_mismatch";
+                invalid_token: "invalid_token";
+                ipc_error: "ipc_error";
+                no_child: "no_child";
+                other: "other";
+                unsupported: "unsupported";
+            }>>;
+            trigger: z.ZodCatch<z.ZodEnum<{
+                heartbeat: "heartbeat";
+                restore: "restore";
+            }>>;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type WorkloadHeartbeatRequestBody = z.infer<typeof WorkloadHeartbeatRequestBody>;
 export declare const WorkloadHeartbeatResponseBody: z.ZodObject<{
     ok: z.ZodLiteral<true>;
+    runToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type WorkloadHeartbeatResponseBody = z.infer<typeof WorkloadHeartbeatResponseBody>;
 export declare const WorkloadSuspendRunResponseBody: import("../../utils/zod.js").CompatibleZodDiscriminatedUnion<readonly [z.ZodObject<{
@@ -360,6 +390,7 @@ export declare const WorkloadRunAttemptStartRequestBody: z.ZodObject<{
     isWarmStart: z.ZodOptional<z.ZodBoolean>;
     workerCell: z.ZodCatch<z.ZodOptional<z.ZodString>>;
     workerLane: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    supportsRunTokenRefresh: z.ZodCatch<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type WorkloadRunAttemptStartRequestBody = z.infer<typeof WorkloadRunAttemptStartRequestBody>;
 export declare const WorkloadRunAttemptStartResponseBody: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{

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

@@ -5,7 +5,7 @@ const v4_1 = require("zod/v4");
 const zod_js_1 = require("../../utils/zod.js");
 const schemas_js_1 = require("../supervisor/schemas.js");
 exports.WorkloadHeartbeatRequestBody = schemas_js_1.WorkerApiRunHeartbeatRequestBody;
-exports.WorkloadHeartbeatResponseBody = schemas_js_1.WorkerApiHeartbeatResponseBody;
+exports.WorkloadHeartbeatResponseBody = schemas_js_1.WorkerApiRunHeartbeatResponseBody;
 exports.WorkloadSuspendRunResponseBody = (0, zod_js_1.discriminatedUnion)("ok", [
     v4_1.z.object({
         ok: v4_1.z.literal(true),

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/v3/runEngineWorker/workload/schemas.ts"],"names":[],"mappings":";;;AAAA,+BAA2B;AAC3B,+CAAwD;AACxD,yDAWkC;AAErB,QAAA,4BAA4B,GAAG,6CAAgC,CAAC;AAGhE,QAAA,6BAA6B,GAAG,2CAA8B,CAAC;AAG/D,QAAA,8BAA8B,GAAG,IAAA,2BAAkB,EAAC,IAAI,EAAE;IACrE,MAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,MAAC,CAAC,OAAO,CAAC,IAAI,CAAC;KACpB,CAAC;IACF,MAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,MAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE;KAClB,CAAC;CACH,CAAC,CAAC;AAGU,QAAA,wCAAwC,GAAG,qDAAwC,CAAC;AAKpF,QAAA,qCAAqC,GAAG,mDAAsC,CAAC;AAK/E,QAAA,sCAAsC,GAAG,oDAAuC,CAAC;AAKjF,QAAA,kCAAkC,GAAG,gDAAmC,CAAC;AAGzE,QAAA,mCAAmC,GAAG,iDAAoC,CAAC;AAK3E,QAAA,qCAAqC,GAAG,mDAAsC,CAAC;AAK/E,QAAA,2BAA2B,GAAG,kCAAqB,CAAC;AAGpD,QAAA,qCAAqC,GAAG,mDAAsC,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/v3/runEngineWorker/workload/schemas.ts"],"names":[],"mappings":";;;AAAA,+BAA2B;AAC3B,+CAAwD;AACxD,yDAWkC;AAErB,QAAA,4BAA4B,GAAG,6CAAgC,CAAC;AAGhE,QAAA,6BAA6B,GAAG,8CAAiC,CAAC;AAGlE,QAAA,8BAA8B,GAAG,IAAA,2BAAkB,EAAC,IAAI,EAAE;IACrE,MAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,MAAC,CAAC,OAAO,CAAC,IAAI,CAAC;KACpB,CAAC;IACF,MAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,MAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,EAAE,MAAC,CAAC,MAAM,EAAE;KAClB,CAAC;CACH,CAAC,CAAC;AAGU,QAAA,wCAAwC,GAAG,qDAAwC,CAAC;AAKpF,QAAA,qCAAqC,GAAG,mDAAsC,CAAC;AAK/E,QAAA,sCAAsC,GAAG,oDAAuC,CAAC;AAKjF,QAAA,kCAAkC,GAAG,gDAAmC,CAAC;AAGzE,QAAA,mCAAmC,GAAG,iDAAoC,CAAC;AAK3E,QAAA,qCAAqC,GAAG,mDAAsC,CAAC;AAK/E,QAAA,2BAA2B,GAAG,kCAAqB,CAAC;AAGpD,QAAA,qCAAqC,GAAG,mDAAsC,CAAC"}

package/dist/commonjs/v3/runToken.d.ts

@@ -0,0 +1,13 @@
+import { type RunTokenSelectionReason } from "./runTokenTelemetry.js";
+/** Format classifier only. The server, not this helper, verifies the signature and authorizes use. */
+export declare function isRunToken(token: string): boolean;
+/**
+ * Resolve an implicit SDK credential per request, including after warm starts and token rotation.
+ * Explicit caller credentials must bypass this helper. This is not JWT verification, and an HTTP
+ * authentication failure must never cause an automatic retry with the fallback credential.
+ */
+export declare function resolveRunTokenCredential(operation: string, fallback: string | undefined, recordSelection?: boolean): string | undefined;
+export declare function resolveRunTokenCredentialSelection(operation: string, fallback: string | undefined, recordSelection?: boolean, branchOverride?: boolean): {
+    accessToken: string | undefined;
+    reason: RunTokenSelectionReason;
+};

package/dist/commonjs/v3/runToken.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRunToken = isRunToken;
+exports.resolveRunTokenCredential = resolveRunTokenCredential;
+exports.resolveRunTokenCredentialSelection = resolveRunTokenCredentialSelection;
+const jose_1 = require("jose");
+const runTokenOperations_js_1 = require("./runTokenOperations.js");
+const runTokenTelemetry_js_1 = require("./runTokenTelemetry.js");
+const task_context_api_js_1 = require("./task-context-api.js");
+const getEnv_js_1 = require("./utils/getEnv.js");
+const RUN_TOKEN_TYPE = "run+jwt";
+const RUN_TOKEN_AUDIENCE = "trigger:api";
+const RUN_TOKEN_USE = "run";
+const JWT_SEGMENT = /^[A-Za-z0-9_-]+$/;
+// Fall back before expiry so a token can't expire between selection and server verification.
+const RUN_TOKEN_EXPIRY_BUFFER_SECONDS = 5 * 60;
+/** Format classifier only. The server, not this helper, verifies the signature and authorizes use. */
+function isRunToken(token) {
+    const parts = token.split(".");
+    if (parts.length !== 3 || !parts.every((part) => JWT_SEGMENT.test(part)))
+        return false;
+    try {
+        return (0, jose_1.decodeProtectedHeader)(token).typ === RUN_TOKEN_TYPE;
+    }
+    catch {
+        return false;
+    }
+}
+function selectionReason(token) {
+    if (!isRunToken(token))
+        return "malformed_token";
+    try {
+        const claims = (0, jose_1.decodeJwt)(token);
+        if (claims.token_use !== RUN_TOKEN_USE ||
+            claims.aud !== RUN_TOKEN_AUDIENCE ||
+            typeof claims.exp !== "number" ||
+            !Number.isFinite(claims.exp) ||
+            !Array.isArray(claims.scopes) ||
+            !claims.scopes.every((scope) => typeof scope === "string")) {
+            return "malformed_token";
+        }
+        if (claims.exp <= Date.now() / 1_000 + RUN_TOKEN_EXPIRY_BUFFER_SECONDS)
+            return "expired_token";
+        if (!claims.scopes.includes("admin"))
+            return "old_scope";
+        return "selected";
+    }
+    catch {
+        return "malformed_token";
+    }
+}
+/**
+ * Resolve an implicit SDK credential per request, including after warm starts and token rotation.
+ * Explicit caller credentials must bypass this helper. This is not JWT verification, and an HTTP
+ * authentication failure must never cause an automatic retry with the fallback credential.
+ */
+function resolveRunTokenCredential(operation, fallback, recordSelection = true) {
+    return resolveRunTokenCredentialSelection(operation, fallback, recordSelection).accessToken;
+}
+function resolveRunTokenCredentialSelection(operation, fallback, recordSelection = true, branchOverride = false) {
+    let reason;
+    let token;
+    if (!task_context_api_js_1.taskContext.isInsideTask) {
+        reason = "outside_task";
+    }
+    else if (branchOverride) {
+        reason = "branch_override";
+    }
+    else if (!(0, runTokenOperations_js_1.supportsRunToken)(operation)) {
+        reason = "unsupported_operation";
+    }
+    else {
+        token = (0, getEnv_js_1.getEnvVar)("TRIGGER_RUN_TOKEN");
+        reason = token ? selectionReason(token) : "missing_token";
+    }
+    const credential = reason === "selected" ? token : fallback;
+    if (recordSelection)
+        (0, runTokenTelemetry_js_1.recordRunTokenSelection)(operation, credential, reason);
+    return { accessToken: credential, reason };
+}
+//# sourceMappingURL=runToken.js.map

package/dist/commonjs/v3/runToken.js.map

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

package/dist/commonjs/v3/runTokenOperations.d.ts

@@ -0,0 +1,125 @@
+/** Audited against the server routes, not inferred from method names or HTTP verbs. */
+export declare const runTokenOperationPolicy: {
+    readonly triggerTask: true;
+    readonly batchTriggerV3: true;
+    readonly createBatch: true;
+    readonly streamBatchItems: true;
+    readonly createUploadPayloadUrl: true;
+    readonly getPayloadUrl: true;
+    readonly getRunPacketUrl: true;
+    readonly retrieveRun: true;
+    readonly cancelRun: true;
+    readonly resetIdempotencyKey: true;
+    readonly addTags: true;
+    readonly updateRunMetadata: true;
+    readonly getRunMetadata: true;
+    readonly createWaitpointToken: true;
+    readonly listWaitpointTokens: true;
+    readonly retrieveWaitpointToken: true;
+    readonly completeWaitpointToken: true;
+    readonly waitForWaitpointToken: true;
+    readonly waitForDuration: true;
+    readonly subscribeToRun: true;
+    readonly subscribeToRunsWithTag: true;
+    readonly subscribeToBatch: true;
+    readonly fetchStream: true;
+    readonly createStream: true;
+    readonly appendToStream: true;
+    readonly sendInputStream: true;
+    readonly createInputStreamWaitpoint: true;
+    readonly legacyStreamIngest: true;
+    readonly legacyStreamResumeProbe: true;
+    readonly createPublicToken: true;
+    readonly retrieveBatch: true;
+    readonly createChatSnapshotUploadUrl: true;
+    readonly getChatSnapshotUrl: true;
+    readonly getSessionTranscript: true;
+    readonly createSession: true;
+    readonly retrieveSession: true;
+    readonly updateSession: true;
+    readonly closeSession: true;
+    readonly endAndContinueSession: true;
+    readonly listSessions: true;
+    readonly initializeSessionStream: true;
+    readonly appendToSessionStream: true;
+    readonly readSessionStreamRecords: true;
+    readonly subscribeToSessionStream: true;
+    readonly createSessionStreamWaitpoint: true;
+    readonly resolvePrompt: true;
+    readonly createWebhookWaiter: true;
+    readonly cancelWebhookWaiter: true;
+    readonly listRuns: true;
+    readonly replayRun: true;
+    readonly createBulkAction: true;
+    readonly listBulkActions: true;
+    readonly retrieveBulkAction: true;
+    readonly abortBulkAction: true;
+    readonly listQueues: true;
+    readonly retrieveQueue: true;
+    readonly pauseQueue: true;
+    readonly overrideQueueConcurrencyLimit: true;
+    readonly resetQueueConcurrencyLimit: true;
+    readonly listConcurrencyLimits: true;
+    readonly retrieveConcurrencyLimit: true;
+    readonly retrieveConcurrencyLimitKey: true;
+    readonly overrideConcurrencyLimit: true;
+    readonly overrideConcurrencyLimitKey: true;
+    readonly pauseConcurrencyLimit: true;
+    readonly resetConcurrencyLimit: true;
+    readonly resetConcurrencyLimitKey: true;
+    readonly listDeployments: true;
+    readonly retrieveCurrentDeployment: true;
+    readonly executeQuery: true;
+    readonly executeQueryProjectOrOrganization: false;
+    readonly listPrompts: true;
+    readonly listPromptVersions: true;
+    readonly promotePromptVersion: true;
+    readonly createPromptOverride: true;
+    readonly updatePromptOverride: true;
+    readonly removePromptOverride: true;
+    readonly reactivatePromptOverride: true;
+    readonly retrieveRunTrace: true;
+    readonly retrieveRunTracePage: true;
+    readonly retrieveSpan: true;
+    readonly listRunEvents: true;
+    readonly getQuerySchema: true;
+    readonly getReport: true;
+    readonly listWebhookEndpoints: true;
+    readonly retrieveWebhookEndpoint: true;
+    readonly generateWebhookEndpointSecret: true;
+    readonly setWebhookEndpointSecret: true;
+    readonly listWebhookDeliveries: true;
+    readonly retrieveWebhookDelivery: true;
+    readonly replayWebhookDelivery: true;
+    readonly getRunResult: false;
+    readonly getBatchResults: false;
+    readonly rescheduleRun: false;
+    readonly createSchedule: false;
+    readonly listSchedules: false;
+    readonly retrieveSchedule: false;
+    readonly updateSchedule: false;
+    readonly deactivateSchedule: false;
+    readonly activateSchedule: false;
+    readonly deleteSchedule: false;
+    readonly listEnvVars: false;
+    readonly importEnvVars: false;
+    readonly retrieveEnvVar: false;
+    readonly createEnvVar: false;
+    readonly updateEnvVar: false;
+    readonly deleteEnvVar: false;
+    readonly generateJWTClaims: false;
+    readonly listProjectRuns: false;
+    readonly listDashboards: false;
+    readonly retrieveDashboard: false;
+    readonly createDashboard: false;
+    readonly updateDashboard: false;
+    readonly replaceDashboard: false;
+    readonly deleteDashboard: false;
+    readonly addDashboardWidget: false;
+    readonly updateDashboardWidget: false;
+    readonly deleteDashboardWidget: false;
+    readonly default: false;
+};
+export type RunTokenOperation = keyof typeof runTokenOperationPolicy;
+export declare function isRunTokenOperation(operation: string): operation is RunTokenOperation;
+export declare function supportsRunToken(operation: string): boolean;