@elaraai/e3-api-client 1.0.87 → 1.0.89

package/README.md

@@ -78,6 +78,16 @@ A view that follows a few datasets asks for those alone:
 named that the workspace has, and the tasks producing them, each as the whole
 status gives it. It costs the server what the view binds, not the workspace.
 
+A poll asks conditionally: `workspaceStatusSince(url, repo, ws, etag, options,
+query)` answers the status with its `ETag`, and `null` while the status
+answered under the tag it was given is current, which costs the server a read
+of the workspace's revision and nothing else. The tag does not name the
+runner's view of an execution recorded running, so a poll that must notice a
+runner gone asks unconditionally (`etag` `null`) now and then. A poll gains
+nothing from retrying a transient failure, since its next poll is its retry:
+`pollRequestOptions(options)` gives it one attempt (`NO_RETRY`) unless the
+caller set a policy of its own.
+
 ### Datasets
 
 ```typescript

package/dist/src/executions.d.ts

@@ -33,6 +33,12 @@ export interface DataflowPollOptions {
  * Returns immediately after spawning execution in background.
  * Use dataflowExecutePoll() to poll for progress.
  *
+ * @remarks
+ * A workspace a run that is stopping still holds is refused with a
+ * `Retry-After`, which the client waits out ({@link retryingRefusal}). One held
+ * otherwise is asked of again a few times, backing off, before the refusal is
+ * raised.
+ *
  * @param url - Base URL of the e3 API server
  * @param repo - Repository name
  * @param workspace - Workspace name
@@ -163,15 +169,35 @@ export declare function dataflowExecutePoll(url: string, repo: string, workspace
  */
 export declare function dataflowBudget(url: string, repo: string, workspace: string, options: RequestOptions): Promise<DataflowBudget | null>;
 /**
- * Cancel a running dataflow execution.
+ * How {@link dataflowCancel} follows the run it cancelled until it has
+ * stopped.
+ */
+export interface DataflowCancelOptions {
+    /** Called once when the run is still stopping after the cancel answered */
+    onStopping?: () => void;
+}
+/**
+ * Cancel a running dataflow execution, and answer once it has stopped.
+ *
+ * @remarks
+ * A server whose run stops where it runs answers the cancel once the run has
+ * ended, as the local one does. One whose run's tasks run in other processes
+ * or machines may answer once the cancel is recorded, its poll answering the
+ * run `stopping` until it has stopped. Either way the client follows the run
+ * it cancelled — the workspace's latest, as the cancel was asked — until its
+ * status is neither `running` nor `stopping`, or another run has followed it.
+ * A start, a deploy or a removal of the workspace straight after finds the
+ * run gone, but for the moment it takes to let the workspace go, which the
+ * server answers with a `Retry-After` that those calls wait out.
  *
  * @param url - Base URL of the API server
  * @param repo - Repository name
  * @param workspace - Workspace name
  * @param options - Request options (token, etc.)
+ * @param cancelOptions - What hears that the run is still stopping
  * @throws {ApiError} `dataflow_error`, "No active execution for this
  *   workspace", when no execution is running; or why else the cancel failed
  * @throws {AuthError} On 401 Unauthorized
  */
-export declare function dataflowCancel(url: string, repo: string, workspace: string, options: RequestOptions): Promise<void>;
+export declare function dataflowCancel(url: string, repo: string, workspace: string, options: RequestOptions, cancelOptions?: DataflowCancelOptions): Promise<void>;
 //# sourceMappingURL=executions.d.ts.map

package/dist/src/executions.d.ts.map

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

package/dist/src/executions.js

@@ -2,16 +2,22 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Licensed under BSL 1.1. See LICENSE for details.
  */
-import { IntegerType, NullType, OptionType, lessFor, none, printFor, some, variant } from '@elaraai/east';
+import { IntegerType, NullType, OptionType, StringType, equalFor, lessFor, none, printFor, some, variant } from '@elaraai/east';
 import { dataflowForce } from '@elaraai/e3-types';
 import { TaskLogChunkType, DataflowRequestType, DataflowGraphType, DataflowBudgetType, DataflowExecutionStateType, } from './types.js';
-import { get, post, verboseQuery, ApiError } from './http.js';
+import { get, post, retryingRefusal, verboseQuery, ApiError } from './http.js';
 /**
  * Start dataflow execution on a workspace (non-blocking).
  *
  * Returns immediately after spawning execution in background.
  * Use dataflowExecutePoll() to poll for progress.
  *
+ * @remarks
+ * A workspace a run that is stopping still holds is refused with a
+ * `Retry-After`, which the client waits out ({@link retryingRefusal}). One held
+ * otherwise is asked of again a few times, backing off, before the refusal is
+ * raised.
+ *
  * @param url - Base URL of the e3 API server
  * @param repo - Repository name
  * @param workspace - Workspace name
@@ -25,14 +31,15 @@ export async function dataflowExecuteLaunch(url, repo, workspace, dataflowOption
     const baseDelay = 200;
     for (let attempt = 0;; attempt++) {
         try {
-            await post(url, verboseQuery(`/repos/${encodeURIComponent(repo)}/workspaces/${encodeURIComponent(workspace)}/dataflow`, options), {
+            await retryingRefusal('workspace_locked', () => post(url, verboseQuery(`/repos/${encodeURIComponent(repo)}/workspaces/${encodeURIComponent(workspace)}/dataflow`, options), {
                 force: dataflowForce(dataflowOptions.force),
                 filter: dataflowOptions.filter != null ? some(dataflowOptions.filter) : none,
-            }, DataflowRequestType, NullType, options);
+            }, DataflowRequestType, NullType, options), options);
             return;
         }
         catch (err) {
-            if (err instanceof ApiError && err.code === 'workspace_locked' && attempt < maxRetries) {
+            // A refusal that names a wait has been waited out already.
+            if (err instanceof ApiError && err.code === 'workspace_locked' && err.retryAfterMs === undefined && attempt < maxRetries) {
                 const delay = baseDelay * Math.pow(2, attempt) * (0.5 + Math.random() * 0.5);
                 await new Promise(r => setTimeout(r, delay));
                 continue;
@@ -262,18 +269,69 @@ export async function dataflowBudget(url, repo, workspace, options) {
     const budget = await get(url, `/repos/${encodeURIComponent(repo)}/workspaces/${encodeURIComponent(workspace)}/dataflow/budget`, OptionType(DataflowBudgetType), options);
     return budget.type === 'some' ? budget.value : null;
 }
+/** How long {@link dataflowCancel} waits between polls of a run that is
+ *  stopping, at first and at most, in milliseconds. */
+const STOPPING_POLL_MIN_MS = 100;
+const STOPPING_POLL_MAX_MS = 2_000;
+/** Whether two runs are one, by their ids. */
+const sameRun = equalFor(StringType);
 /**
- * Cancel a running dataflow execution.
+ * The id of a workspace's latest run, or `null` when it has none.
  *
  * @param url - Base URL of the API server
  * @param repo - Repository name
  * @param workspace - Workspace name
  * @param options - Request options (token, etc.)
+ * @returns The run's id, or `null`
+ */
+async function latestRunId(url, repo, workspace, options) {
+    try {
+        return (await dataflowExecutePoll(url, repo, workspace, { limit: 0 }, options)).runId;
+    }
+    catch (err) {
+        if (err instanceof ApiError && err.code === 'execution_not_found')
+            return null;
+        throw err;
+    }
+}
+/**
+ * Cancel a running dataflow execution, and answer once it has stopped.
+ *
+ * @remarks
+ * A server whose run stops where it runs answers the cancel once the run has
+ * ended, as the local one does. One whose run's tasks run in other processes
+ * or machines may answer once the cancel is recorded, its poll answering the
+ * run `stopping` until it has stopped. Either way the client follows the run
+ * it cancelled — the workspace's latest, as the cancel was asked — until its
+ * status is neither `running` nor `stopping`, or another run has followed it.
+ * A start, a deploy or a removal of the workspace straight after finds the
+ * run gone, but for the moment it takes to let the workspace go, which the
+ * server answers with a `Retry-After` that those calls wait out.
+ *
+ * @param url - Base URL of the API server
+ * @param repo - Repository name
+ * @param workspace - Workspace name
+ * @param options - Request options (token, etc.)
+ * @param cancelOptions - What hears that the run is still stopping
  * @throws {ApiError} `dataflow_error`, "No active execution for this
  *   workspace", when no execution is running; or why else the cancel failed
  * @throws {AuthError} On 401 Unauthorized
  */
-export async function dataflowCancel(url, repo, workspace, options) {
+export async function dataflowCancel(url, repo, workspace, options, cancelOptions = {}) {
+    const run = await latestRunId(url, repo, workspace, options);
     await post(url, `/repos/${encodeURIComponent(repo)}/workspaces/${encodeURIComponent(workspace)}/dataflow/cancel`, null, NullType, NullType, options);
+    if (run === null)
+        return;
+    let told = false;
+    for (let wait = STOPPING_POLL_MIN_MS;; wait = Math.min(wait * 2, STOPPING_POLL_MAX_MS)) {
+        const state = await dataflowExecutePoll(url, repo, workspace, { limit: 0 }, options);
+        if (!sameRun(state.runId, run) || (state.status.type !== 'running' && state.status.type !== 'stopping'))
+            return;
+        if (!told) {
+            told = true;
+            cancelOptions.onStopping?.();
+        }
+        await new Promise((resolve) => setTimeout(resolve, wait));
+    }
 }
 //# sourceMappingURL=executions.js.map

package/dist/src/executions.js.map

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

package/dist/src/http.d.ts

@@ -101,7 +101,16 @@ export declare function verboseQuery(path: string, options: RequestOptions): str
 export declare class ApiError extends Error {
     readonly code: string;
     readonly details?: unknown | undefined;
-    constructor(code: string, details?: unknown | undefined);
+    readonly retryAfterMs?: number | undefined;
+    /**
+     * @param code - The error's code
+     * @param details - What the server said of it
+     * @param retryAfterMs - How long the server asks the client to wait before
+     *   it asks again, in milliseconds, as the refusal's `Retry-After` says:
+     *   a workspace a run that is stopping still holds is refused with one
+     *   ({@link retryingRefusal}); `undefined` when it names none
+     */
+    constructor(code: string, details?: unknown | undefined, retryAfterMs?: number | undefined);
 }
 /**
  * A read pinned to a content hash the dataset no longer holds (a 409
@@ -128,6 +137,24 @@ export declare class DatasetHashMismatchError extends ApiError {
 export declare class AuthError extends Error {
     constructor(message: string);
 }
+/**
+ * A retry policy of one attempt: a poll's, whose next poll is its retry.
+ *
+ * @remarks
+ * A call that is made again a second later gains nothing from retrying a
+ * transient failure in between, and a server under load is asked once per
+ * poll rather than four times. {@link pollRequestOptions} gives a poll this
+ * policy unless its caller set one.
+ */
+export declare const NO_RETRY: RetryOptions;
+/**
+ * The request options of a poll: the caller's, with {@link NO_RETRY} unless
+ * the caller set a policy of its own.
+ *
+ * @param options - The caller's request options
+ * @returns The options a poll's request is made with
+ */
+export declare function pollRequestOptions(options: RequestOptions): RequestOptions;
 /**
  * Whether a thrown `fetch` error is a connection-level failure where the request
  * did not complete, so a retry cannot double-apply. An `AbortError` is never
@@ -228,6 +255,39 @@ export declare function parseErrorBody(text: string, fallbackCode: string): ApiE
  * @throws {AuthError} On 401 Unauthorized
  */
 export declare function get<T extends EastType>(url: string, path: string, successType: T, options: RequestOptions): Promise<ValueTypeOf<T>>;
+/**
+ * An answer a conditional GET was given, with the tag it carries: what a
+ * client sends back to ask whether the answer has changed.
+ */
+export interface Conditional<T> {
+    /** The answer's value */
+    readonly value: T;
+    /** The answer's `ETag`; `null` when the server named none, in which case
+     *  the next ask is unconditional */
+    readonly etag: string | null;
+}
+/**
+ * Make a conditional GET request: the answer, decoded, with the `ETag` it
+ * carries; or `null` when the server answers `304 Not Modified` to the tag
+ * sent as `If-None-Match`, which says the answer the client holds is current.
+ *
+ * @remarks
+ * A poll holds the tag of the last answer it was given and asks with it: an
+ * unchanged status costs the server a read of the workspace's revision, and
+ * the client no decoding. A server that names no tag answers in full every
+ * time, and the next ask is unconditional.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param path - The request's path under `/api`
+ * @param successType - The type of the answer's value
+ * @param etag - The tag of the answer the client holds; `null` for none
+ * @param options - Request options including auth token
+ * @returns The answer and its tag, or `null` when the one the client holds is
+ *   current
+ * @throws {ApiError} On application-level errors
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export declare function getConditional<T extends EastType>(url: string, path: string, successType: T, etag: string | null, options: RequestOptions): Promise<Conditional<ValueTypeOf<T>> | null>;
 /**
  * Make a POST request with BEAST2 body and decode BEAST2 response.
  * @param extraHeaders - Optional additional request headers (e.g. `Idempotency-Key`), merged after the defaults.
@@ -253,22 +313,81 @@ export declare function del<T extends EastType>(url: string, path: string, succe
  * @throws {AuthError} On 401 Unauthorized
  */
 export declare function putEmpty<T extends EastType>(url: string, path: string, successType: T, options: RequestOptions): Promise<ValueTypeOf<T>>;
+/**
+ * An answer, with what its response says beside its value: whether the server
+ * took the request on to finish after answering (`202 Accepted`), where it
+ * says to follow it, and when to ask.
+ */
+export interface Answered<T> {
+    /** The answer's value */
+    readonly value: T;
+    /** Whether the server answered `202 Accepted` */
+    readonly accepted: boolean;
+    /** The URL the answer's `Location` names, resolved against the request's;
+     *  `null` when it names none */
+    readonly location: string | null;
+    /** The answer's `Retry-After`, in milliseconds; `undefined` when it names
+     *  none */
+    readonly retryAfterMs: number | undefined;
+}
+/**
+ * Make a request of a URL and decode its BEAST2 answer, keeping what the
+ * response says beside its value: whether the server accepted the request to
+ * finish after answering, the `Location` it names and its `Retry-After`.
+ *
+ * @param target - The request's URL, whole: a route's, or one a `Location`
+ *   named
+ * @param method - `GET` or `DELETE`, either of which a retry sends again
+ * @param successType - The type of the answer's value
+ * @param options - Request options including auth token
+ * @returns The answer
+ * @throws {ApiError} On application-level errors
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export declare function requestAnswered<T extends EastType>(target: string, method: 'GET' | 'DELETE', successType: T, options: RequestOptions): Promise<Answered<ValueTypeOf<T>>>;
+/**
+ * How long, in all, {@link retryingRefusal} waits out a refusal its server
+ * says to ask again of, in milliseconds, before it raises it.
+ */
+export declare const RETRY_REFUSAL_MAX_MS: number;
+/**
+ * Makes a call, and while its server refuses it with `code` and a
+ * `Retry-After`, waits as the server says and makes it again.
+ *
+ * @remarks
+ * A server refuses a start, a deploy or a workspace's removal so
+ * (`workspace_locked`) while a run that is stopping still holds the workspace:
+ * the run lets it go. A refusal with no `Retry-After`, or of another code, is
+ * raised at once, and so is one still refused after
+ * {@link RETRY_REFUSAL_MAX_MS}. Each wait is bounded as a `Retry-After` is
+ * ({@link RetryOptions.maxRetryAfterMs}).
+ *
+ * @param code - The refusal's code
+ * @param call - The call, made again for each retry
+ * @param options - Request options: the wait's bound
+ * @returns What the call answers
+ * @throws {ApiError} The refusal, once it is raised; or what else the call
+ *   throws
+ */
+export declare function retryingRefusal<T>(code: string, call: () => Promise<T>, options: RequestOptions): Promise<T>;
 /**
  * Fetch a URL with streaming download progress reporting.
  *
  * Falls back to a single `arrayBuffer()` call if no `onProgress` callback
  * is provided or if the response has no readable body stream.
  *
- * The initial request is retried per {@link fetchWithRetry} (GET is idempotent);
- * once streaming begins a mid-stream failure surfaces, since a partial download
- * cannot be safely resumed.
+ * The initial request is retried per {@link fetchWithRetry} (GET is idempotent),
+ * under the caller's policy when given; once streaming begins a mid-stream
+ * failure surfaces, since a partial download cannot be safely resumed.
  *
  * @param url - The URL to download
  * @param onProgress - Told the bytes downloaded so far and the total
  * @param signal - Aborts the download
  * @param fetch - The `fetch` the download goes through
  *   ({@link RequestOptions.fetch}); the global one when absent
+ * @param retry - The retry policy of the request ({@link RequestOptions.retry});
+ *   the default when absent
  * @returns The downloaded bytes
  */
-export declare function fetchWithProgress(url: string, onProgress?: (downloaded: number, total: number) => void, signal?: AbortSignal, fetch?: typeof globalThis.fetch): Promise<Uint8Array>;
+export declare function fetchWithProgress(url: string, onProgress?: (downloaded: number, total: number) => void, signal?: AbortSignal, fetch?: typeof globalThis.fetch, retry?: RetryOptions): Promise<Uint8Array>;
 //# sourceMappingURL=http.d.ts.map

package/dist/src/http.d.ts.map

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

package/dist/src/http.js

@@ -29,10 +29,20 @@ export function verboseQuery(path, options) {
 export class ApiError extends Error {
     code;
     details;
-    constructor(code, details) {
+    retryAfterMs;
+    /**
+     * @param code - The error's code
+     * @param details - What the server said of it
+     * @param retryAfterMs - How long the server asks the client to wait before
+     *   it asks again, in milliseconds, as the refusal's `Retry-After` says:
+     *   a workspace a run that is stopping still holds is refused with one
+     *   ({@link retryingRefusal}); `undefined` when it names none
+     */
+    constructor(code, details, retryAfterMs) {
         super(`API error: ${code}`);
         this.code = code;
         this.details = details;
+        this.retryAfterMs = retryAfterMs;
         this.name = 'ApiError';
     }
 }
@@ -101,6 +111,26 @@ const DEFAULT_RETRY = {
     maxDelayMs: 2000,
     maxRetryAfterMs: 30_000,
 };
+/**
+ * A retry policy of one attempt: a poll's, whose next poll is its retry.
+ *
+ * @remarks
+ * A call that is made again a second later gains nothing from retrying a
+ * transient failure in between, and a server under load is asked once per
+ * poll rather than four times. {@link pollRequestOptions} gives a poll this
+ * policy unless its caller set one.
+ */
+export const NO_RETRY = { attempts: 1 };
+/**
+ * The request options of a poll: the caller's, with {@link NO_RETRY} unless
+ * the caller set a policy of its own.
+ *
+ * @param options - The caller's request options
+ * @returns The options a poll's request is made with
+ */
+export function pollRequestOptions(options) {
+    return options.retry === undefined ? { ...options, retry: NO_RETRY } : options;
+}
 /** Merge caller overrides onto {@link DEFAULT_RETRY}, clamping to sane bounds. */
 function resolveRetry(retry) {
     return {
@@ -377,6 +407,43 @@ export async function get(url, path, successType, options) {
     }, { idempotent: true, retry: options.retry, fetch: options.fetch });
     return decodeResponse(response, successType);
 }
+/**
+ * Make a conditional GET request: the answer, decoded, with the `ETag` it
+ * carries; or `null` when the server answers `304 Not Modified` to the tag
+ * sent as `If-None-Match`, which says the answer the client holds is current.
+ *
+ * @remarks
+ * A poll holds the tag of the last answer it was given and asks with it: an
+ * unchanged status costs the server a read of the workspace's revision, and
+ * the client no decoding. A server that names no tag answers in full every
+ * time, and the next ask is unconditional.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param path - The request's path under `/api`
+ * @param successType - The type of the answer's value
+ * @param etag - The tag of the answer the client holds; `null` for none
+ * @param options - Request options including auth token
+ * @returns The answer and its tag, or `null` when the one the client holds is
+ *   current
+ * @throws {ApiError} On application-level errors
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export async function getConditional(url, path, successType, etag, options) {
+    const response = await fetchWithRetry(`${url}/api${path}`, {
+        method: 'GET',
+        headers: {
+            'Accept': BEAST2_CONTENT_TYPE,
+            ...(etag === null ? {} : { 'If-None-Match': etag }),
+            ...(options.token ? { 'Authorization': `Bearer ${options.token}` } : {}),
+        },
+    }, { idempotent: true, retry: options.retry, fetch: options.fetch });
+    if (response.status === 304) {
+        await response.body?.cancel().catch(() => { });
+        return null;
+    }
+    const value = await decodeResponse(response, successType);
+    return { value, etag: response.headers.get('etag') };
+}
 /**
  * Make a POST request with BEAST2 body and decode BEAST2 response.
  * @param extraHeaders - Optional additional request headers (e.g. `Idempotency-Key`), merged after the defaults.
@@ -463,31 +530,107 @@ async function decodeResponse(response, successType) {
     // Decode BEAST2 response
     const bytes = new Uint8Array(await response.arrayBuffer());
     const result = decodeBeast2For(ResponseType(successType))(bytes);
-    // Handle application-level errors in BEAST2 response
+    // Handle application-level errors in BEAST2 response, with the wait a
+    // refusal the server asks to be asked again of names
     if (result.type === 'error') {
-        throw new ApiError(result.value.type, result.value.value);
+        throw new ApiError(result.value.type, result.value.value, parseRetryAfter(response.headers.get('retry-after'), Date.now()));
     }
     return result.value;
 }
+/**
+ * Make a request of a URL and decode its BEAST2 answer, keeping what the
+ * response says beside its value: whether the server accepted the request to
+ * finish after answering, the `Location` it names and its `Retry-After`.
+ *
+ * @param target - The request's URL, whole: a route's, or one a `Location`
+ *   named
+ * @param method - `GET` or `DELETE`, either of which a retry sends again
+ * @param successType - The type of the answer's value
+ * @param options - Request options including auth token
+ * @returns The answer
+ * @throws {ApiError} On application-level errors
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export async function requestAnswered(target, method, successType, options) {
+    const response = await fetchWithRetry(target, {
+        method,
+        headers: {
+            'Accept': BEAST2_CONTENT_TYPE,
+            ...(options.token ? { 'Authorization': `Bearer ${options.token}` } : {}),
+        },
+    }, { idempotent: true, retry: options.retry, fetch: options.fetch });
+    const location = response.headers.get('location');
+    const retryAfterMs = parseRetryAfter(response.headers.get('retry-after'), Date.now());
+    const value = await decodeResponse(response, successType);
+    return {
+        value,
+        accepted: response.status === 202,
+        location: location === null ? null : new URL(location, target).toString(),
+        retryAfterMs,
+    };
+}
+/**
+ * How long, in all, {@link retryingRefusal} waits out a refusal its server
+ * says to ask again of, in milliseconds, before it raises it.
+ */
+export const RETRY_REFUSAL_MAX_MS = 5 * 60_000;
+/**
+ * Makes a call, and while its server refuses it with `code` and a
+ * `Retry-After`, waits as the server says and makes it again.
+ *
+ * @remarks
+ * A server refuses a start, a deploy or a workspace's removal so
+ * (`workspace_locked`) while a run that is stopping still holds the workspace:
+ * the run lets it go. A refusal with no `Retry-After`, or of another code, is
+ * raised at once, and so is one still refused after
+ * {@link RETRY_REFUSAL_MAX_MS}. Each wait is bounded as a `Retry-After` is
+ * ({@link RetryOptions.maxRetryAfterMs}).
+ *
+ * @param code - The refusal's code
+ * @param call - The call, made again for each retry
+ * @param options - Request options: the wait's bound
+ * @returns What the call answers
+ * @throws {ApiError} The refusal, once it is raised; or what else the call
+ *   throws
+ */
+export async function retryingRefusal(code, call, options) {
+    const cfg = resolveRetry(options.retry);
+    const deadline = Date.now() + RETRY_REFUSAL_MAX_MS;
+    for (;;) {
+        try {
+            return await call();
+        }
+        catch (err) {
+            if (!(err instanceof ApiError) || err.code !== code || err.retryAfterMs === undefined)
+                throw err;
+            const wait = Math.min(err.retryAfterMs, cfg.maxRetryAfterMs);
+            if (Date.now() + wait > deadline)
+                throw err;
+            await sleep(wait);
+        }
+    }
+}
 /**
  * Fetch a URL with streaming download progress reporting.
  *
  * Falls back to a single `arrayBuffer()` call if no `onProgress` callback
  * is provided or if the response has no readable body stream.
  *
- * The initial request is retried per {@link fetchWithRetry} (GET is idempotent);
- * once streaming begins a mid-stream failure surfaces, since a partial download
- * cannot be safely resumed.
+ * The initial request is retried per {@link fetchWithRetry} (GET is idempotent),
+ * under the caller's policy when given; once streaming begins a mid-stream
+ * failure surfaces, since a partial download cannot be safely resumed.
  *
  * @param url - The URL to download
  * @param onProgress - Told the bytes downloaded so far and the total
  * @param signal - Aborts the download
  * @param fetch - The `fetch` the download goes through
  *   ({@link RequestOptions.fetch}); the global one when absent
+ * @param retry - The retry policy of the request ({@link RequestOptions.retry});
+ *   the default when absent
  * @returns The downloaded bytes
  */
-export async function fetchWithProgress(url, onProgress, signal, fetch) {
-    const res = await fetchWithRetry(url, { method: 'GET', signal }, { idempotent: true, fetch });
+export async function fetchWithProgress(url, onProgress, signal, fetch, retry) {
+    const res = await fetchWithRetry(url, { method: 'GET', signal }, { idempotent: true, retry, fetch });
     if (!res.ok)
         throw new Error(`Download failed: ${res.status} ${res.statusText}`);
     if (!onProgress || !res.body) {