@trigger.dev/core 0.0.0-prerelease-20260508094307 → 0.0.0-prerelease-deployment-base-image-20260814120901

package/dist/esm/v3/apiClient/index.js

@@ -1,14 +1,17 @@
+import { nanoid } from "nanoid";
 import { z } from "zod";
 import { VERSION } from "../../version.js";
+import { isAdditionalApiKey } from "../apiKeys.js";
 import { generateJWT } from "../jwt.js";
-import { ApiDeploymentListResponseItem, AppendToStreamResponseBody, BatchTaskRunExecutionResult, BatchTriggerTaskV3Response, CanceledRunResponse, CompleteWaitpointTokenResponseBody, CreateBatchResponse, CreateInputStreamWaitpointResponseBody, CreateStreamResponseBody, CreateUploadPayloadUrlResponseBody, CreateWaitpointTokenResponseBody, DeletedScheduleObject, EnvironmentVariableResponseBody, EnvironmentVariableWithSecret, ListRunResponseItem, QueueItem, QueryExecuteResponseBody, QuerySchemaResponseBody, ListDashboardsResponseBody, ReplayRunResponse, ResetIdempotencyKeyResponse, RetrieveBatchV2Response, ResolvePromptResponseBody, ListPromptsResponseBody, ListPromptVersionsResponseBody, PromptOkResponseBody, PromptOverrideCreatedResponseBody, RetrieveRunResponse, RetrieveRunTraceResponseBody, RetrieveSpanDetailResponseBody, ScheduleObject, SendInputStreamResponseBody, StreamBatchItemsResponse, TaskRunExecutionResult, TriggerTaskResponse, UpdateMetadataResponseBody, WaitForDurationResponseBody, WaitForWaitpointTokenResponseBody, WaitpointRetrieveTokenResponse, WaitpointTokenItem, } from "../schemas/index.js";
+import { AbortBulkActionResponseBody, ApiDeploymentListResponseItem, BulkActionObject, CreateBulkActionResponseBody, AppendToStreamResponseBody, BatchTaskRunExecutionResult, BatchTriggerTaskV3Response, CanceledRunResponse, CompleteWaitpointTokenResponseBody, CreateBatchResponse, CreateInputStreamWaitpointResponseBody, CreateSessionStreamWaitpointResponseBody, CreateStreamResponseBody, CreateUploadPayloadUrlResponseBody, CreateWaitpointTokenResponseBody, CreatedSessionResponseBody, DeletedScheduleObject, EndAndContinueSessionResponseBody, EnvironmentVariableResponseBody, EnvironmentVariableWithSecret, ListDashboardsResponseBody, ListPromptVersionsResponseBody, ListPromptsResponseBody, ListRunResponseItem, ListedSessionItem, PromptOkResponseBody, PromptOverrideCreatedResponseBody, QueryExecuteResponseBody, QuerySchemaResponseBody, QueueItem, ReadSessionStreamRecordsResponseBody, ReplayRunResponse, ReportViewModelSchema, ResetIdempotencyKeyResponse, ResolvePromptResponseBody, RetrieveBatchV2Response, RetrieveCurrentDeploymentResponseBody, RetrieveRunResponse, RetrieveRunTraceResponseBody, RetrieveSessionResponseBody, RetrieveSpanDetailResponseBody, ScheduleObject, SendInputStreamResponseBody, StreamBatchItemsResponse, TaskRunExecutionResult, TriggerTaskResponse, UpdateMetadataResponseBody, WaitForDurationResponseBody, WaitForWaitpointTokenResponseBody, WaitpointRetrieveTokenResponse, WaitpointTokenItem, } from "../schemas/index.js";
+import { controlSubtype } from "../sessionStreams/wireProtocol.js";
 import { taskContext } from "../task-context-api.js";
+import { getEnvVar } from "../utils/getEnv.js";
+import { calculateNextRetryDelay } from "../utils/retries.js";
 import { isRequestOptions, zodfetch, zodfetchCursorPage, zodfetchOffsetLimitPage, } from "./core.js";
 import { ApiConnectionError, ApiError, BatchNotSealedError } from "./errors.js";
-import { calculateNextRetryDelay } from "../utils/retries.js";
-import { SSEStreamSubscriptionFactory, SSEStreamSubscription, runShapeStream, } from "./runStream.js";
+import { SSEStreamSubscription, SSEStreamSubscriptionFactory, runShapeStream, } from "./runStream.js";
 import { API_VERSION, API_VERSION_HEADER_NAME } from "./version.js";
-import { getEnvVar } from "../utils/getEnv.js";
 const DEFAULT_ZOD_FETCH_OPTIONS = {
     retry: {
         maxAttempts: 5,
@@ -18,8 +21,9 @@ const DEFAULT_ZOD_FETCH_OPTIONS = {
         randomize: false,
     },
 };
-export { isRequestOptions, SSEStreamSubscription };
+export { SSEStreamSubscription, isRequestOptions };
 export * from "./getBranch.js";
+const CreatePublicTokenResponseBody = z.object({ token: z.string() });
 /**
  * Trigger.dev v3 API client
  */
@@ -30,7 +34,10 @@ export class ApiClient {
     futureFlags;
     additionalHeaders;
     defaultRequestOptions;
-    constructor(baseUrl, accessToken, previewBranch, requestOptions = {}, futureFlags = {}) {
+    constructor(baseUrl, accessToken, 
+    // Carries the branch for any branchable env (preview or dev) — both ride the
+    // x-trigger-branch header, and the server disambiguates by the token's env.
+    previewBranch, requestOptions = {}, futureFlags = {}) {
         this.accessToken = accessToken;
         this.baseUrl = baseUrl.replace(/\/$/, "");
         this.previewBranch = previewBranch;
@@ -39,6 +46,17 @@ export class ApiClient {
         this.defaultRequestOptions = mergeRequestOptions(DEFAULT_ZOD_FETCH_OPTIONS, restRequestOptions);
         this.futureFlags = futureFlags;
     }
+    /**
+     * Key for signing a public access token locally. Only root keys can do this —
+     * an additional key isn't the environment's signing material, so a token
+     * signed with one would never verify. Throw rather than return a dead token.
+     */
+    get #selfSigningKey() {
+        if (isAdditionalApiKey(this.accessToken)) {
+            throw new Error("This additional API key cannot self-sign public tokens, and the server did not return one. Upgrade the server or use the root API key.");
+        }
+        return this.accessToken;
+    }
     get fetchClient() {
         const headers = this.#getHeaders(false);
         const fetchClient = (input, requestInit) => {
@@ -97,7 +115,7 @@ export class ApiClient {
             const claimsHeader = response.headers.get("x-trigger-jwt-claims");
             const claims = claimsHeader ? JSON.parse(claimsHeader) : undefined;
             const jwt = await generateJWT({
-                secretKey: this.accessToken,
+                secretKey: this.#selfSigningKey,
                 payload: {
                     ...claims,
                     scopes: [`read:runs:${data.id}`],
@@ -120,10 +138,17 @@ export class ApiClient {
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions))
             .withResponse()
             .then(async ({ data, response }) => {
+            const jwtHeader = response.headers.get("x-trigger-jwt");
+            if (typeof jwtHeader === "string") {
+                return {
+                    ...data,
+                    publicAccessToken: jwtHeader,
+                };
+            }
             const claimsHeader = response.headers.get("x-trigger-jwt-claims");
             const claims = claimsHeader ? JSON.parse(claimsHeader) : undefined;
             const jwt = await generateJWT({
-                secretKey: this.accessToken,
+                secretKey: this.#selfSigningKey,
                 payload: {
                     ...claims,
                     scopes: [`read:batch:${data.id}`],
@@ -156,10 +181,17 @@ export class ApiClient {
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions))
             .withResponse()
             .then(async ({ data, response }) => {
+            const jwtHeader = response.headers.get("x-trigger-jwt");
+            if (typeof jwtHeader === "string") {
+                return {
+                    ...data,
+                    publicAccessToken: jwtHeader,
+                };
+            }
             const claimsHeader = response.headers.get("x-trigger-jwt-claims");
             const claims = claimsHeader ? JSON.parse(claimsHeader) : undefined;
             const jwt = await generateJWT({
-                secretKey: this.accessToken,
+                secretKey: this.#selfSigningKey,
                 payload: {
                     ...claims,
                     scopes: [`read:batch:${data.id}`],
@@ -309,6 +341,20 @@ export class ApiClient {
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    /** Presigned PUT URL for a `chat.agent` session snapshot. */
+    createChatSnapshotUploadUrl(sessionId, requestOptions) {
+        return zodfetch(CreateUploadPayloadUrlResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionId)}/snapshot-url`, {
+            method: "PUT",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    /** Presigned GET URL for a `chat.agent` session snapshot. */
+    getChatSnapshotUrl(sessionId, requestOptions) {
+        return zodfetch(CreateUploadPayloadUrlResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionId)}/snapshot-url`, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
     retrieveRun(runId, requestOptions) {
         return zodfetch(RetrieveRunResponse, `${this.baseUrl}/api/v3/runs/${runId}`, {
             method: "GET",
@@ -366,6 +412,36 @@ export class ApiClient {
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    createBulkAction(options, requestOptions) {
+        return zodfetch(CreateBulkActionResponseBody, `${this.baseUrl}/api/v1/bulk-actions`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(options),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    listBulkActions(query, requestOptions) {
+        return zodfetchCursorPage(BulkActionObject, `${this.baseUrl}/api/v1/bulk-actions`, {
+            query: new URLSearchParams(),
+            limit: query?.limit,
+            after: query?.after,
+            before: query?.before,
+        }, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    retrieveBulkAction(bulkActionId, requestOptions) {
+        return zodfetch(BulkActionObject, `${this.baseUrl}/api/v1/bulk-actions/${bulkActionId}`, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    abortBulkAction(bulkActionId, requestOptions) {
+        return zodfetch(AbortBulkActionResponseBody, `${this.baseUrl}/api/v1/bulk-actions/${bulkActionId}/abort`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
     resetIdempotencyKey(taskIdentifier, idempotencyKey, requestOptions) {
         return zodfetch(ResetIdempotencyKeyResponse, `${this.baseUrl}/api/v1/idempotencyKeys/${encodeURIComponent(idempotencyKey)}/reset`, {
             method: "POST",
@@ -518,7 +594,7 @@ export class ApiClient {
                 const claimsHeader = response.headers.get("x-trigger-jwt-claims");
                 const claims = claimsHeader ? JSON.parse(claimsHeader) : undefined;
                 const jwt = await generateJWT({
-                    secretKey: this.accessToken,
+                    secretKey: this.#selfSigningKey,
                     payload: {
                         ...claims,
                         scopes: [`write:waitpoints:${data.id}`],
@@ -565,6 +641,157 @@ export class ApiClient {
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    // ========================================================================
+    // Sessions
+    // ========================================================================
+    createSession(body, requestOptions) {
+        return zodfetch(CreatedSessionResponseBody, `${this.baseUrl}/api/v1/sessions`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    retrieveSession(sessionIdOrExternalId, requestOptions) {
+        return zodfetch(RetrieveSessionResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}`, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    updateSession(sessionIdOrExternalId, body, requestOptions) {
+        return zodfetch(RetrieveSessionResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}`, {
+            method: "PATCH",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    closeSession(sessionIdOrExternalId, body, requestOptions) {
+        return zodfetch(RetrieveSessionResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/close`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body ?? {}),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    endAndContinueSession(sessionIdOrExternalId, body, requestOptions) {
+        return zodfetch(EndAndContinueSessionResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/end-and-continue`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    listSessions(options, requestOptions) {
+        const searchParams = createSearchQueryForListSessions(options);
+        return zodfetchCursorPage(ListedSessionItem, `${this.baseUrl}/api/v1/sessions`, {
+            query: searchParams,
+            limit: options?.limit,
+            after: options?.after,
+            before: options?.before,
+        }, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    // ========================================================================
+    // Session realtime channels
+    // ========================================================================
+    async initializeSessionStream(sessionIdOrExternalId, io, requestOptions) {
+        // The server returns S2 credentials in response headers alongside a tiny
+        // JSON body with the realtime version. Follow the same shape as
+        // `createStream` so downstream clients can feed them into
+        // `StreamsWriterV2`.
+        return zodfetch(CreateStreamResponseBody, `${this.baseUrl}/realtime/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/${io}`, {
+            method: "PUT",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions))
+            .withResponse()
+            .then(({ data, response }) => ({
+            ...data,
+            headers: Object.fromEntries(response.headers.entries()),
+        }));
+    }
+    async appendToSessionStream(sessionIdOrExternalId, io, part, requestOptions) {
+        // Generated once per logical append, outside zodfetch, so its internal
+        // retries reuse the same part id and the server-side dedupe collapses a
+        // retried POST whose first attempt actually committed. Full-length nanoid
+        // (~126 bits) to match the browser transport's randomUUID entropy.
+        const partId = nanoid();
+        return zodfetch(AppendToStreamResponseBody, `${this.baseUrl}/realtime/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/${io}/append`, {
+            method: "POST",
+            headers: { ...this.#getHeaders(false), "X-Part-Id": partId },
+            body: part,
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    /**
+     * Non-SSE drain of a Session channel's tail. Returns whatever records
+     * exist after `afterEventId` (or from the head of the stream) and closes
+     * — `wait=0` semantics, no long-poll. Used by `replaySessionOutTail` at
+     * run boot, where the SSE long-poll's ~1s tax on empty streams is the
+     * dominant cost on every fresh chat.
+     *
+     * `afterEventId` is the same cursor format as the SSE Last-Event-ID
+     * (the S2 sequence number, stringified) — pass `lastOutEventId` from a
+     * persisted snapshot to resume.
+     */
+    async readSessionStreamRecords(sessionIdOrExternalId, io, options) {
+        const qs = new URLSearchParams();
+        if (options?.afterEventId !== undefined) {
+            qs.set("afterEventId", options.afterEventId);
+        }
+        const url = `${options?.baseUrl ?? this.baseUrl}/realtime/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/${io}/records${qs.toString() ? `?${qs.toString()}` : ""}`;
+        return zodfetch(ReadSessionStreamRecordsResponseBody, url, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, undefined));
+    }
+    /**
+     * Subscribe to SSE records on a Session channel. Reuses the same
+     * {@link SSEStreamSubscription} plumbing as `readStream` for run-scoped
+     * realtime streams — auto-retry, Last-Event-ID resume, abort-on-cancel.
+     */
+    async subscribeToSessionStream(sessionIdOrExternalId, io, options) {
+        const url = `${options?.baseUrl ?? this.baseUrl}/realtime/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/${io}`;
+        const subscription = new SSEStreamSubscription(url, {
+            headers: this.getHeaders(),
+            signal: options?.signal,
+            onComplete: options?.onComplete,
+            onError: options?.onError,
+            timeoutInSeconds: options?.timeoutInSeconds,
+            lastEventId: options?.lastEventId,
+        });
+        const stream = await subscription.subscribe();
+        const onPart = options?.onPart;
+        const onControl = options?.onControl;
+        return stream.pipeThrough(new TransformStream({
+            transform(part, controller) {
+                // Always surface the raw part via onPart so cursor tracking
+                // (lastSeqNum, lastEventId) stays correct for both data and
+                // control records.
+                onPart?.(part);
+                // Trigger control record — route to onControl, never enqueue.
+                const subtype = controlSubtype(part.headers);
+                if (subtype) {
+                    // `part.id` is the S2 seq_num in decimal string form.
+                    // `parseInt` returns NaN if S2 ever surfaces a non-numeric
+                    // id (shouldn't happen, but `|| 0` would mask it as a real
+                    // seq 0). Drop the malformed event rather than fire
+                    // `onControl` with a misleading cursor — callers like
+                    // `findLatestSessionInCursor` and the dashboard rely on the
+                    // seqNum being meaningful for resume.
+                    const parsedSeqNum = Number.parseInt(part.id, 10);
+                    if (!Number.isFinite(parsedSeqNum)) {
+                        return;
+                    }
+                    onControl?.({
+                        subtype,
+                        headers: part.headers ?? [],
+                        seqNum: parsedSeqNum,
+                        timestamp: part.timestamp,
+                    });
+                    return;
+                }
+                controller.enqueue(part.chunk);
+            },
+        }));
+    }
     async waitForDuration(runId, body, requestOptions) {
         return zodfetch(WaitForDurationResponseBody, `${this.baseUrl}/engine/v1/runs/${runId}/wait/duration`, {
             method: "POST",
@@ -702,6 +929,12 @@ export class ApiClient {
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    retrieveCurrentDeployment(requestOptions) {
+        return zodfetch(RetrieveCurrentDeploymentResponseBody, `${this.baseUrl}/api/v1/deployments/current`, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
     async fetchStream(runId, streamKey, options) {
         const streamFactory = new SSEStreamSubscriptionFactory(options?.baseUrl ?? this.baseUrl, {
             headers: this.getHeaders(),
@@ -757,12 +990,26 @@ export class ApiClient {
             body: JSON.stringify(body),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    async createSessionStreamWaitpoint(runFriendlyId, body, requestOptions) {
+        return zodfetch(CreateSessionStreamWaitpointResponseBody, `${this.baseUrl}/api/v1/runs/${runFriendlyId}/session-streams/wait`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
     async generateJWTClaims(requestOptions) {
         return zodfetch(z.record(z.any()), `${this.baseUrl}/api/v1/auth/jwt/claims`, {
             method: "POST",
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    async createPublicToken(body, requestOptions) {
+        return zodfetch(CreatePublicTokenResponseBody, `${this.baseUrl}/api/v1/auth/public-tokens`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
     retrieveBatch(batchId, requestOptions) {
         return zodfetch(RetrieveBatchV2Response, `${this.baseUrl}/api/v2/batches/${batchId}`, {
             method: "GET",
@@ -796,6 +1043,24 @@ export class ApiClient {
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    async getReport(key, options) {
+        const searchParams = new URLSearchParams({ format: options?.format ?? "markdown" });
+        if (options?.period) {
+            searchParams.set("period", options.period);
+        }
+        const response = await fetch(`${this.baseUrl}/api/v1/reports/${encodeURIComponent(key)}?${searchParams.toString()}`, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        });
+        if (!response.ok) {
+            const bodySnippet = await readBodySnippet(response);
+            throw new Error(`Failed to fetch report "${key}": ${response.status} ${response.statusText}${bodySnippet ? ` — ${bodySnippet}` : ""}`);
+        }
+        if (options?.format === "json") {
+            return ReportViewModelSchema.parse(await response.json());
+        }
+        return response.text();
+    }
     #getHeaders(spanParentAsLink, additionalHeaders) {
         const headers = {
             "Content-Type": "application/json",
@@ -948,6 +1213,9 @@ function createSearchQueryForListRuns(query) {
         if (query.machine) {
             searchParams.append("filter[machine]", Array.isArray(query.machine) ? query.machine.join(",") : query.machine);
         }
+        if (query.region) {
+            searchParams.append("filter[region]", Array.isArray(query.region) ? query.region.join(",") : query.region);
+        }
     }
     return searchParams;
 }
@@ -957,6 +1225,33 @@ function queueNameFromQueueTypeName(queue) {
     }
     return queue.name;
 }
+function createSearchQueryForListSessions(options) {
+    const searchParams = new URLSearchParams();
+    if (!options)
+        return searchParams;
+    const appendMany = (name, value) => {
+        if (value === undefined)
+            return;
+        searchParams.append(name, Array.isArray(value) ? value.join(",") : value);
+    };
+    appendMany("filter[type]", options.type);
+    appendMany("filter[tags]", options.tag);
+    appendMany("filter[taskIdentifier]", options.taskIdentifier);
+    if (options.externalId) {
+        searchParams.append("filter[externalId]", options.externalId);
+    }
+    appendMany("filter[status]", options.status);
+    if (options.period) {
+        searchParams.append("filter[createdAt][period]", options.period);
+    }
+    if (options.from !== undefined) {
+        searchParams.append("filter[createdAt][from]", options.from instanceof Date ? options.from.getTime().toString() : options.from.toString());
+    }
+    if (options.to !== undefined) {
+        searchParams.append("filter[createdAt][to]", options.to instanceof Date ? options.to.getTime().toString() : options.to.toString());
+    }
+    return searchParams;
+}
 function createSearchQueryForListWaitpointTokens(query) {
     const searchParams = new URLSearchParams();
     if (query) {
@@ -1056,6 +1351,22 @@ function shouldRetryStreamBatchItems(response, attempt, retryOptions) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+/**
+ * Best-effort read of a (likely error) response body for inclusion in a thrown Error.
+ * Never throws, and truncates so we don't dump a huge HTML page into an error message.
+ */
+async function readBodySnippet(response, maxLength = 500) {
+    try {
+        const text = (await response.text()).trim();
+        if (!text) {
+            return "";
+        }
+        return text.length > maxLength ? `${text.slice(0, maxLength)}…` : text;
+    }
+    catch {
+        return "";
+    }
+}
 /**
  * Safely cancels a ReadableStream, handling the case where it might be locked.
  *