@opengeni/sdk 4.4.1 → 4.5.0

package/dist/{chunk-PVWOBYAZ.js → chunk-BXMNDWAN.js}

@@ -18,7 +18,7 @@ import {
   OPENGENI_API_CONTRACT_REVISION,
   OPENGENI_CORRELATION_HEADER,
   RETAINED_OUTPUT_MAX_PAGE_BYTES
-} from "./chunk-BLID3DCD.js";
+} from "./chunk-V4AIZAFF.js";
 import {
   OpenGeniInteractionClient,
   decodeComputerFrameMetadataHeader,
@@ -390,6 +390,118 @@ function withDeprecationNotices(fetchImpl, handler) {
   };
 }
 
+// src/read-retry.ts
+var DEFAULT_READ_RETRY_POLICY = Object.freeze({
+  maxAttempts: 4,
+  initialDelayMs: 250,
+  maxDelayMs: 2e3,
+  maxElapsedMs: 5e3
+});
+var MAX_READ_RETRY_ATTEMPTS = 10;
+var MAX_READ_RETRY_ELAPSED_MS = 6e4;
+function boundedNumber(value, fallback, min, max) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+  return Math.min(Math.max(value, min), max);
+}
+function resolveReadRetryPolicy(options) {
+  if (options === false) return null;
+  const input = options && typeof options === "object" ? options : {};
+  const maxAttempts = Math.floor(
+    boundedNumber(
+      input.maxAttempts,
+      DEFAULT_READ_RETRY_POLICY.maxAttempts,
+      1,
+      MAX_READ_RETRY_ATTEMPTS
+    )
+  );
+  if (maxAttempts <= 1) return null;
+  const maxElapsedMs = boundedNumber(
+    input.maxElapsedMs,
+    DEFAULT_READ_RETRY_POLICY.maxElapsedMs,
+    0,
+    MAX_READ_RETRY_ELAPSED_MS
+  );
+  const maxDelayMs = boundedNumber(
+    input.maxDelayMs,
+    DEFAULT_READ_RETRY_POLICY.maxDelayMs,
+    0,
+    MAX_READ_RETRY_ELAPSED_MS
+  );
+  const initialDelayMs = boundedNumber(
+    input.initialDelayMs,
+    DEFAULT_READ_RETRY_POLICY.initialDelayMs,
+    0,
+    maxDelayMs
+  );
+  return { maxAttempts, initialDelayMs, maxDelayMs, maxElapsedMs };
+}
+function isSafeReadMethod(method) {
+  const normalized = method.toUpperCase();
+  return normalized === "GET" || normalized === "HEAD";
+}
+function isTransientGatewayStatus(status) {
+  return status === 502 || status === 503 || status === 504;
+}
+var transportFailures = /* @__PURE__ */ new WeakSet();
+function markTransportFailure(error) {
+  if (error instanceof TypeError) transportFailures.add(error);
+}
+var invalidResponses = /* @__PURE__ */ new WeakSet();
+function invalidApiResponseError(body, options) {
+  const error = new OpenGeniApiError(502, body, options);
+  invalidResponses.add(error);
+  return error;
+}
+var NETWORK_FAILURE_MESSAGE = /failed to fetch|fetch failed|networkerror|network error|load failed|network request failed|network connection was lost|terminated|err_http2|econnreset|socket hang up/iu;
+function isTransientRequestError(error) {
+  if (error instanceof OpenGeniApiError) {
+    return !invalidResponses.has(error) && isTransientGatewayStatus(error.status) && error.retryable;
+  }
+  if (!(error instanceof TypeError)) return false;
+  return transportFailures.has(error) || NETWORK_FAILURE_MESSAGE.test(error.message);
+}
+function parseRetryAfterMs(value, now = Date.now()) {
+  if (value === null || value === void 0) return null;
+  const trimmed = value.trim();
+  if (!trimmed) return null;
+  if (/^\d+$/.test(trimmed)) {
+    const seconds = Number(trimmed);
+    return Number.isSafeInteger(seconds) ? seconds * 1e3 : null;
+  }
+  if (!/[A-Za-z]/.test(trimmed)) return null;
+  const at = Date.parse(trimmed);
+  if (!Number.isFinite(at)) return null;
+  return Math.max(0, at - now);
+}
+function readRetryDelayMs(policy, retry, elapsedMs, retryAfterMs, random = Math.random) {
+  if (retry >= policy.maxAttempts) return null;
+  let delay;
+  if (retryAfterMs !== null) {
+    delay = retryAfterMs * (1 + 0.2 * Math.min(Math.max(random(), 0), 1));
+  } else {
+    const base = Math.min(policy.maxDelayMs, policy.initialDelayMs * 2 ** (retry - 1));
+    delay = base / 2 + base / 2 * Math.min(Math.max(random(), 0), 1);
+  }
+  if (elapsedMs + delay > policy.maxElapsedMs) return null;
+  return Math.round(delay);
+}
+function abortableReadRetryDelay(ms, signal) {
+  if (signal?.aborted) {
+    return Promise.reject(signal.reason ?? new DOMException("Request aborted", "AbortError"));
+  }
+  return new Promise((resolve, reject) => {
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signal?.reason ?? new DOMException("Request aborted", "AbortError"));
+    };
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+
 // src/workspace-control-stream.ts
 async function* streamWorkspaceControlEvents(transport, options = {}) {
   const signal = options.signal;
@@ -614,7 +726,8 @@ function parseWorkspaceLiveEvent(data) {
   }
   if (!isRecord2(value)) return null;
   if (value.type === "workspace.sessions.changed" && typeof value.workspaceId === "string" && typeof value.available === "boolean" && (value.sessionIds === null || Array.isArray(value.sessionIds) && value.sessionIds.every((id) => typeof id === "string"))) {
-    return value;
+    const { siteSessionIds, ...hint } = value;
+    return Array.isArray(siteSessionIds) && siteSessionIds.every((id) => typeof id === "string") ? { ...hint, siteSessionIds } : hint;
   }
   if (typeof value.sequence !== "number") return null;
   if (value.type === "workspace.control.changed" && typeof value.id === "string" && Number.isSafeInteger(value.sequence)) {
@@ -1019,6 +1132,7 @@ var OpenGeniClient = class {
   fetchImpl;
   sessionCommandTimeoutMs;
   apiContractStrict;
+  readRetryPolicy;
   active = /* @__PURE__ */ new Map();
   generations = /* @__PURE__ */ new Map();
   queued = /* @__PURE__ */ new Map();
@@ -1039,6 +1153,7 @@ var OpenGeniClient = class {
     }
     this.sessionCommandTimeoutMs = sessionCommandTimeoutMs;
     this.apiContractStrict = defaultApiContractMode(options) === "strict";
+    this.readRetryPolicy = resolveReadRetryPolicy(options.readRetry);
     this.interaction = new OpenGeniInteractionClient(this);
     this.tools = createLazyToolsFacade(this);
   }
@@ -1130,7 +1245,7 @@ var OpenGeniClient = class {
       options.signal ? { signal: options.signal } : {}
     );
     if (!isTranscriptionRecordingListResponse(body)) {
-      throw new OpenGeniApiError(502, "Invalid transcription recording list response.", {
+      throw invalidApiResponseError("Invalid transcription recording list response.", {
         code: "invalid_response"
       });
     }
@@ -1586,6 +1701,7 @@ var OpenGeniClient = class {
       if (options.mineOnly) query.mineOnly = "true";
       if (options.includePinned === false) query.includePinned = "false";
       if (options.archivedOnly) query.archivedOnly = "true";
+      if (options.siteConversations) query.siteConversations = options.siteConversations;
       result = await this.requestJson(
         "GET",
         path,
@@ -1634,6 +1750,16 @@ var OpenGeniClient = class {
       throw unsupportedSessionPage("Site access-filtered session lists");
     return response;
   }
+  /**
+   * Record that this person opened a Site, which orders its sidebar row like
+   * session activity. Personal; needs `artifacts:read`.
+   */
+  async recordSiteOpened(workspaceId, siteId) {
+    return this.requestJson(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/published-artifacts/${encodeURIComponent(siteId)}/opened`
+    );
+  }
   /** Console/owner-authorized agent only. Never available through the Site frame bridge. */
   async listSiteSessionAccess(workspaceId, siteId) {
     return this.requestJson(
@@ -3409,7 +3535,7 @@ var OpenGeniClient = class {
     const header = response.headers.get("x-opengeni-browser-frame");
     if (mediaType !== "image/jpeg" && mediaType !== "image/png" || !header || header.length > 64 * 1024) {
       await cancelResponseBody(response, "browser frame metadata is invalid");
-      throw new OpenGeniApiError(502, "browser frame metadata is invalid");
+      throw invalidApiResponseError("browser frame metadata is invalid");
     }
     let metadata;
     try {
@@ -3418,11 +3544,11 @@ var OpenGeniClient = class {
       );
     } catch {
       await cancelResponseBody(response, "browser frame metadata is invalid");
-      throw new OpenGeniApiError(502, "browser frame metadata is invalid");
+      throw invalidApiResponseError("browser frame metadata is invalid");
     }
     const data = await readBoundedResponseBytes(response, 24 * 1024 * 1024, null);
     if (metadata.browserSessionId !== browserSessionId || metadata.targetId !== targetId || metadata.mediaType !== mediaType) {
-      throw new OpenGeniApiError(502, "browser frame evidence does not match its request");
+      throw invalidApiResponseError("browser frame evidence does not match its request");
     }
     return { ...metadata, data };
   }
@@ -3453,7 +3579,7 @@ var OpenGeniClient = class {
       options
     );
     if (state.browserSessionId !== browserSessionId || state.targetId !== targetId) {
-      throw new OpenGeniApiError(502, "browser target state belongs to another binding");
+      throw invalidApiResponseError("browser target state belongs to another binding");
     }
     return state;
   }
@@ -3466,7 +3592,7 @@ var OpenGeniClient = class {
       options
     );
     if (result.browserSessionId !== browserSessionId || result.targetId !== targetId || result.kind !== request.kind || result.targetGeneration !== request.expectedTargetGeneration || result.documentGeneration !== request.expectedDocumentGeneration || result.frameId !== request.expectedFrameId) {
-      throw new OpenGeniApiError(502, "browser DOM read belongs to another binding");
+      throw invalidApiResponseError("browser DOM read belongs to another binding");
     }
     return result;
   }
@@ -3677,19 +3803,19 @@ var OpenGeniClient = class {
     const mediaType = response.headers.get("content-type")?.split(";", 1)[0]?.trim().toLowerCase();
     if (mediaType !== "image/jpeg" && mediaType !== "image/png") {
       await cancelResponseBody(response, "computer frame media type is invalid");
-      throw new OpenGeniApiError(502, "computer frame media type is invalid");
+      throw invalidApiResponseError("computer frame media type is invalid");
     }
     const metadataHeader = response.headers.get("x-opengeni-computer-frame");
     if (!metadataHeader || metadataHeader.length > 32 * 1024) {
       await cancelResponseBody(response, "computer frame metadata is invalid");
-      throw new OpenGeniApiError(502, "computer frame metadata is invalid");
+      throw invalidApiResponseError("computer frame metadata is invalid");
     }
     let metadata;
     try {
       metadata = decodeComputerFrameMetadataHeader(metadataHeader);
     } catch {
       await cancelResponseBody(response, "computer frame metadata is invalid");
-      throw new OpenGeniApiError(502, "computer frame metadata is invalid");
+      throw invalidApiResponseError("computer frame metadata is invalid");
     }
     const bytes = await readBoundedResponseBytes(response, 256 * 1024, null);
     const mismatchReason = computerFrameEvidenceMismatchReason(metadata, {
@@ -3699,7 +3825,7 @@ var OpenGeniClient = class {
       sha256: await sha256Hex(bytes)
     });
     if (mismatchReason) {
-      throw new OpenGeniApiError(502, "computer frame evidence does not match its request");
+      throw invalidApiResponseError("computer frame evidence does not match its request");
     }
     return { ...metadata, data: bytes };
   }
@@ -5440,7 +5566,7 @@ var OpenGeniClient = class {
     if (!metadata.available) return { metadata, bytes: null };
     const supportedScreenshot = (metadata.kind === "computer_screenshot" || metadata.kind === "browser_screenshot") && ["image/png", "image/jpeg", "image/webp"].includes(metadata.contentType);
     if (!supportedScreenshot || !metadata.dimensions || metadata.originalBytes <= 0 || metadata.originalBytes > COMPUTER_SCREENSHOT_MAX_BYTES) {
-      throw new OpenGeniApiError(502, "retained screenshot metadata is invalid");
+      throw invalidApiResponseError("retained screenshot metadata is invalid");
     }
     const bytes = await this.downloadRetainedArtifactBytes(metadata, options);
     return { metadata, bytes };
@@ -5453,7 +5579,7 @@ var OpenGeniClient = class {
     const bytes = new Uint8Array(artifact.originalBytes);
     const pageBytes = Math.min(artifact.retrieval.maxRangeBytes, RETAINED_OUTPUT_MAX_PAGE_BYTES);
     if (!Number.isSafeInteger(pageBytes) || pageBytes <= 0) {
-      throw new OpenGeniApiError(502, "retained artifact range metadata is invalid");
+      throw invalidApiResponseError("retained artifact range metadata is invalid");
     }
     for (let start = 0; start < bytes.byteLength; start += pageBytes) {
       options.signal?.throwIfAborted();
@@ -5473,15 +5599,15 @@ var OpenGeniClient = class {
           }
         }
       }
-      if (!page) throw new OpenGeniApiError(502, "retained artifact range retry exhausted");
+      if (!page) throw invalidApiResponseError("retained artifact range retry exhausted");
       const expectedLength = end - start + 1;
       if (page.status !== 206 || page.contentType !== artifact.contentType || page.contentLength !== expectedLength || page.contentRange !== `bytes ${start}-${end}/${artifact.originalBytes}`) {
-        throw new OpenGeniApiError(502, "retained artifact range response is invalid");
+        throw invalidApiResponseError("retained artifact range response is invalid");
       }
       bytes.set(page.bytes, start);
     }
     if (await sha256Hex(bytes) !== artifact.sha256) {
-      throw new OpenGeniApiError(502, "retained artifact checksum mismatch");
+      throw invalidApiResponseError("retained artifact checksum mismatch");
     }
     return bytes;
   }
@@ -5517,7 +5643,7 @@ var OpenGeniClient = class {
     }
     if (response.headers.get("accept-ranges") !== "bytes") {
       await cancelResponseBody(response, "retained artifact response omitted byte-range support");
-      throw new OpenGeniApiError(502, "retained artifact response omitted byte-range support");
+      throw invalidApiResponseError("retained artifact response omitted byte-range support");
     }
     let declaredLength;
     try {
@@ -7819,63 +7945,114 @@ var OpenGeniClient = class {
     const correlationId = crypto.randomUUID();
     const abort = requestAbortSignal(options);
     try {
-      if (abort.signal?.aborted) {
-        throw abort.signal.reason ?? new DOMException("Request aborted", "AbortError");
-      }
-      const headers = this.headers(correlationId);
-      let response;
-      try {
-        response = await awaitWithAbort(
-          this.fetchImpl(this.url(path, query), {
-            method,
-            headers: {
-              ...headers,
-              Accept: "application/json",
-              ...body !== void 0 ? { "Content-Type": "application/json" } : {}
-            },
-            ...body !== void 0 ? { body: JSON.stringify(body) } : {},
-            ...abort.signal ? { signal: abort.signal } : {}
-          }),
-          abort.signal
+      const retryPolicy = isSafeReadMethod(method) ? this.readRetryPolicy : null;
+      if (!retryPolicy) {
+        return await this.requestJsonAttempt(
+          method,
+          path,
+          body,
+          query,
+          options,
+          abort.signal,
+          correlationId,
+          null
         );
-      } catch (error) {
-        if (options.signal?.aborted) throw error;
-        if (isMutationMethod(method)) {
-          throw mutationTransportError(correlationId);
-        }
-        throw error;
       }
-      assertApiContractResponse(response, this.apiContractStrict);
-      try {
-        if (!response.ok) {
-          throw await awaitWithAbort(
-            apiErrorFromResponse(response, { method, correlationId }),
-            abort.signal
+      const startedAt = Date.now();
+      for (let retry = 1; ; retry += 1) {
+        const attempt = {
+          transportFailure: false,
+          gatewayFailure: false,
+          retryAfterMs: null
+        };
+        try {
+          return await this.requestJsonAttempt(
+            method,
+            path,
+            body,
+            query,
+            options,
+            abort.signal,
+            correlationId,
+            attempt
           );
-        }
-        if (options.responseType === "void") {
-          await awaitWithAbort(
-            cancelResponseBody(response, "discarding void API response"),
-            abort.signal
+        } catch (error) {
+          const transient = attempt.transportFailure || attempt.gatewayFailure && isTransientRequestError(error);
+          if (abort.signal?.aborted || !transient) throw error;
+          const delay = readRetryDelayMs(
+            retryPolicy,
+            retry,
+            Date.now() - startedAt,
+            attempt.retryAfterMs
           );
-          return void 0;
+          if (delay === null) throw error;
+          await abortableReadRetryDelay(delay, abort.signal);
         }
-        await awaitWithAbort(assertJsonResponse(response, { method, correlationId }), abort.signal);
-        const value = await awaitWithAbort(response.json(), abort.signal);
-        recordObservedSessionSequence(value, response.headers.get(SESSION_SEQUENCE_HEADER));
-        return value;
-      } catch (error) {
-        if (options.signal?.aborted) throw error;
-        if (error instanceof OpenGeniApiError) throw error;
-        if (isMutationMethod(method)) {
-          throw mutationTransportError(correlationId);
-        }
-        throw error;
       }
     } finally {
       abort.dispose();
     }
   }
+  async requestJsonAttempt(method, path, body, query, options, signal, correlationId, attempt) {
+    if (signal?.aborted) {
+      throw signal.reason ?? new DOMException("Request aborted", "AbortError");
+    }
+    const headers = this.headers(correlationId);
+    let response;
+    try {
+      response = await awaitWithAbort(
+        this.fetchImpl(this.url(path, query), {
+          method,
+          headers: {
+            ...headers,
+            Accept: "application/json",
+            ...body !== void 0 ? { "Content-Type": "application/json" } : {}
+          },
+          ...body !== void 0 ? { body: JSON.stringify(body) } : {},
+          ...signal ? { signal } : {}
+        }),
+        signal
+      );
+    } catch (error) {
+      if (options.signal?.aborted) throw error;
+      if (isMutationMethod(method)) {
+        throw mutationTransportError(correlationId);
+      }
+      if (error instanceof TypeError && attempt) attempt.transportFailure = true;
+      markTransportFailure(error);
+      throw error;
+    }
+    assertApiContractResponse(response, this.apiContractStrict);
+    try {
+      if (!response.ok) {
+        if (attempt && isTransientGatewayStatus(response.status)) {
+          attempt.gatewayFailure = true;
+          attempt.retryAfterMs = parseRetryAfterMs(response.headers.get("retry-after"));
+        }
+        throw await awaitWithAbort(
+          apiErrorFromResponse(response, { method, correlationId }),
+          signal
+        );
+      }
+      if (options.responseType === "void") {
+        await awaitWithAbort(cancelResponseBody(response, "discarding void API response"), signal);
+        return void 0;
+      }
+      await awaitWithAbort(assertJsonResponse(response, { method, correlationId }), signal);
+      const value = await awaitWithAbort(response.json(), signal);
+      recordObservedSessionSequence(value, response.headers.get(SESSION_SEQUENCE_HEADER));
+      return value;
+    } catch (error) {
+      if (options.signal?.aborted) throw error;
+      if (error instanceof OpenGeniApiError) throw error;
+      if (isMutationMethod(method)) {
+        throw mutationTransportError(correlationId);
+      }
+      if (error instanceof TypeError && attempt) attempt.transportFailure = true;
+      markTransportFailure(error);
+      throw error;
+    }
+  }
   /** Authenticated, contract-checked response for bounded streaming downloads. */
   async requestResponse(method, path, query = {}, options = {}) {
     const correlationId = crypto.randomUUID();
@@ -7965,7 +8142,7 @@ function isTranscriptionRecordingResponse(value) {
 }
 function transcriptionRecordingResponse(value) {
   if (isTranscriptionRecordingResponse(value)) return value;
-  throw new OpenGeniApiError(502, "Invalid transcription recording response.", {
+  throw invalidApiResponseError("Invalid transcription recording response.", {
     code: "invalid_response"
   });
 }
@@ -8062,7 +8239,7 @@ async function apiErrorFromResponse(response, context) {
 async function assertJsonResponse(response, context) {
   if (isJsonContentType(response.headers.get("content-type"))) return;
   await cancelResponseBody(response, "unexpected non-JSON API response");
-  throw new OpenGeniApiError(502, "", {
+  throw invalidApiResponseError("", {
     code: "upstream_unavailable",
     retryable: true,
     correlationId: response.headers.get(OPENGENI_CORRELATION_HEADER) ?? context.correlationId,
@@ -8137,44 +8314,44 @@ async function cancelResponseBody(response, reason) {
 }
 function assertRetainedWorkspaceArtifactReceipt(workspaceId, artifact) {
   if (!parseRetainedGeneratedImageReference(artifact, workspaceId) && !parseRetainedWorkspaceFileReference(artifact, workspaceId)) {
-    throw new OpenGeniApiError(502, "retained workspace artifact receipt is invalid");
+    throw invalidApiResponseError("retained workspace artifact receipt is invalid");
   }
 }
 function assertSafeArtifactDownloadUrl(value) {
   if (!value || typeof value.url !== "string" || typeof value.expiresAt !== "string" || !Number.isFinite(Date.parse(value.expiresAt))) {
-    throw new OpenGeniApiError(502, "retained artifact download URL is invalid");
+    throw invalidApiResponseError("retained artifact download URL is invalid");
   }
   let parsed;
   try {
     parsed = new URL(value.url);
   } catch {
-    throw new OpenGeniApiError(502, "retained artifact download URL is invalid");
+    throw invalidApiResponseError("retained artifact download URL is invalid");
   }
   if (!["http:", "https:"].includes(parsed.protocol) || parsed.username || parsed.password) {
-    throw new OpenGeniApiError(502, "retained artifact download URL is unsafe");
+    throw invalidApiResponseError("retained artifact download URL is unsafe");
   }
 }
 function assertSafeVideoArtifactPlaybackSource(value, expectedArtifactId) {
   if (!value || value.schemaVersion !== 1 || value.artifactId !== expectedArtifactId || value.contentType !== "video/mp4" || value.acceptRanges !== "bytes" || !Number.isSafeInteger(value.sizeBytes) || value.sizeBytes <= 0 || value.sizeBytes > GENERATED_VIDEO_MAX_BYTES || !/^[0-9a-f]{64}$/.test(value.sha256)) {
-    throw new OpenGeniApiError(502, "generated-video playback source is invalid");
+    throw invalidApiResponseError("generated-video playback source is invalid");
   }
   assertSafeArtifactDownloadUrl({ url: value.url, expiresAt: value.expiresAt });
 }
 function parseBoundedContentLength(value) {
   if (value === null) return null;
   if (!/^\d+$/.test(value)) {
-    throw new OpenGeniApiError(502, "invalid retained artifact content-length");
+    throw invalidApiResponseError("invalid retained artifact content-length");
   }
   const length = Number(value);
   if (!Number.isSafeInteger(length) || length > RETAINED_OUTPUT_MAX_PAGE_BYTES) {
-    throw new OpenGeniApiError(502, "retained artifact response exceeds the SDK byte limit");
+    throw invalidApiResponseError("retained artifact response exceeds the SDK byte limit");
   }
   return length;
 }
 async function readBoundedResponseBytes(response, maxBytes, expectedBytes) {
   if (!response.body) {
     if (expectedBytes !== null && expectedBytes !== 0) {
-      throw new OpenGeniApiError(502, "retained artifact response length mismatch");
+      throw invalidApiResponseError("retained artifact response length mismatch");
     }
     return new Uint8Array();
   }
@@ -8188,7 +8365,7 @@ async function readBoundedResponseBytes(response, maxBytes, expectedBytes) {
       totalBytes += value.byteLength;
       if (totalBytes > maxBytes) {
         await reader.cancel("retained artifact response exceeded the SDK byte limit").catch(() => void 0);
-        throw new OpenGeniApiError(502, "retained artifact response exceeds the SDK byte limit");
+        throw invalidApiResponseError("retained artifact response exceeds the SDK byte limit");
       }
       chunks.push(value);
     }
@@ -8196,7 +8373,7 @@ async function readBoundedResponseBytes(response, maxBytes, expectedBytes) {
     reader.releaseLock();
   }
   if (expectedBytes !== null && totalBytes !== expectedBytes) {
-    throw new OpenGeniApiError(502, "retained artifact response length mismatch");
+    throw invalidApiResponseError("retained artifact response length mismatch");
   }
   const bytes = new Uint8Array(totalBytes);
   let offset = 0;
@@ -8228,6 +8405,7 @@ export {
   vaultErrorCode,
   vaultErrorDetail,
   parseDeprecationNotice,
+  isTransientRequestError,
   streamWorkspaceControlEvents,
   streamWorkspaceInteractionRevisions,
   streamWorkspaceLiveEvents,
@@ -8242,4 +8420,4 @@ export {
   parseMediaGenerationResult,
   OpenGeniClient
 };
-//# sourceMappingURL=chunk-PVWOBYAZ.js.map
+//# sourceMappingURL=chunk-BXMNDWAN.js.map