@worldlabsai/client 0.3.0 → 0.4.0

package/src/core/transport.ts

@@ -1,3 +1,4 @@
+import { NetworkError } from "./network-error.ts";
 import { sleep } from "./sleep.ts";
 
 /** Handles a `Request` for API calls and signed uploads; standard `fetch` is compatible. */
@@ -8,7 +9,11 @@ export type Fetch = (request: Request) => Promise<Response>;
  * without calling `next`, call `next` more than once for retries, or inspect the response.
  * Clone requests before sending them if a retry may need to reuse the body.
  */
-export type Middleware = (request: Request, next: Fetch) => Promise<Response>;
+export type Middleware = (
+  request: Request,
+  next: Fetch,
+  options?: Pick<RequestOptions, "retry">,
+) => Promise<Response>;
 
 /** Values accepted in a request query. `null` and `undefined` are omitted. */
 export type QueryValue = string | number | boolean | null | undefined;
@@ -40,7 +45,19 @@ export interface TransportOptions {
   pathParams?: Record<string, string>;
 }
 
-/** FastAPI puts its reason under `detail`; operation and storage errors use `message`. */
+/** One FastAPI validation issue, `{ loc: ["body", "frames"], msg: "Field required" }`. */
+const validationIssue = (issue: unknown): string => {
+  const location: unknown =
+    typeof issue === "object" && issue !== null ? Reflect.get(issue, "loc") : undefined;
+  const message: unknown =
+    typeof issue === "object" && issue !== null ? Reflect.get(issue, "msg") : issue;
+  return Array.isArray(location) ? `${location.join(".")}: ${String(message)}` : String(message);
+};
+
+/**
+ * FastAPI puts its reason under `detail`, as a list of validation issues for a
+ * 422; operation and storage errors use `message`.
+ */
 const errorDetail = (body: unknown): string | undefined => {
   if (typeof body !== "object" || body === null) {
     return undefined;
@@ -50,6 +67,9 @@ const errorDetail = (body: unknown): string | undefined => {
     if (typeof value === "string" && value !== "") {
       return value;
     }
+    if (Array.isArray(value) && value.length > 0) {
+      return value.map((issue) => validationIssue(issue)).join("; ");
+    }
   }
   return undefined;
 };
@@ -82,11 +102,15 @@ const fillPath = (path: string, params: Record<string, string>): string =>
     return encodeURIComponent(value);
   });
 
-const compose = (middleware: Middleware[], fetch: Fetch): Fetch => {
+const compose = (
+  middleware: Middleware[],
+  fetch: Fetch,
+  options?: Pick<RequestOptions, "retry">,
+): Fetch => {
   let next = fetch;
   for (const layer of middleware.toReversed()) {
     const inner = next;
-    next = async (request) => await layer(request, inner);
+    next = async (request) => await layer(request, inner, options);
   }
   return next;
 };
@@ -105,17 +129,27 @@ const parseBody = async (response: Response): Promise<unknown> => {
 
 const RETRYABLE_STATUS_CODES = new Set([429, 502, 503, 504]);
 
-const retryDelay = (error: unknown, attempt: number): number => {
-  const backoff = 1000 * 2 ** attempt * (0.5 + Math.random() / 2);
+/**
+ * Longest `Retry-After` a retry waits out. A concurrency cap, an hourly quota,
+ * or a closed task names minutes to hours, which the caller has to surface
+ * rather than sit through.
+ */
+const MAX_RETRY_AFTER_MS = 10_000;
+
+/** The wait a response names in `Retry-After`, as seconds or an HTTP date. */
+const retryAfterMs = (error: unknown): number | undefined => {
   const value =
     error instanceof ApiError ? error.response.headers.get("retry-after")?.trim() : undefined;
   if (!value) {
-    return backoff;
+    return undefined;
   }
   const delay = /^\d+$/u.test(value) ? Number(value) * 1000 : Date.parse(value) - Date.now();
-  return Math.max(backoff, Number.isFinite(delay) ? delay : 0);
+  return Number.isFinite(delay) ? Math.max(0, delay) : undefined;
 };
 
+const retryDelay = (error: unknown, attempt: number): number =>
+  Math.max(1000 * 2 ** attempt * (0.5 + Math.random() / 2), retryAfterMs(error) ?? 0);
+
 export interface Transport {
   /**
    * Send a request and parse its response as JSON, falling back to text.
@@ -150,10 +184,8 @@ export const createTransport = (options: TransportOptions): Transport => {
   return {
     fetch,
     send,
-    request: async <T>(
-      path: string,
-      { body, params, query, retry = false, ...init }: RequestOptions = {},
-    ): Promise<T> => {
+    request: async <T>(path: string, requestOptions: RequestOptions = {}): Promise<T> => {
+      const { body, params, query, retry = false, ...init } = requestOptions;
       const url = new URL(baseUrl + fillPath(path, { ...boundParams, ...params }));
       for (const [key, value] of Object.entries(query ?? {})) {
         if (value !== undefined && value !== null) {
@@ -172,16 +204,18 @@ export const createTransport = (options: TransportOptions): Transport => {
 
       // Provider and middleware TypeErrors must not be mistaken for network failures.
       let networkError: unknown;
-      const sendRequest = retry
-        ? compose(options.middleware ?? [], async (attempt) => {
-            try {
-              return await fetch(attempt);
-            } catch (error) {
-              networkError = error;
-              throw error;
-            }
-          })
-        : send;
+      const sendRequest = compose(
+        options.middleware ?? [],
+        async (attempt) => {
+          try {
+            return await fetch(attempt);
+          } catch (error) {
+            networkError = error;
+            throw error;
+          }
+        },
+        requestOptions,
+      );
 
       // oxlint-disable no-await-in-loop -- retries are sequential and preserve the original request
       for (let attempt = 0; ; attempt += 1) {
@@ -206,11 +240,14 @@ export const createTransport = (options: TransportOptions): Transport => {
           return parsed as T;
         } catch (error) {
           request.signal.throwIfAborted();
+          const networkFailure = error instanceof TypeError && error === networkError;
           const transient =
             error instanceof ApiError
-              ? RETRYABLE_STATUS_CODES.has(error.response.status)
-              : error instanceof TypeError && error === networkError;
+              ? RETRYABLE_STATUS_CODES.has(error.response.status) &&
+                (retryAfterMs(error) ?? 0) <= MAX_RETRY_AFTER_MS
+              : networkFailure;
           if (!retry || attempt >= 3 || !transient) {
+            if (networkFailure) throw new NetworkError(error);
             throw error;
           }
           await sleep(retryDelay(error, attempt), request.signal);

package/src/generated/developer-api.gen.ts

@@ -430,6 +430,11 @@ export interface components {
              * @description Already percent-encoded path for the asset. Append it unchanged to ``baseUrl`` before ``?`` and ``signedQuery``. This path does not grant access by itself. Null until the asset is ``READY`` or when unavailable; use ``assets/{asset}:createReadUrl`` as a fallback.
              */
             contentPath?: string | null;
+            /**
+             * Url
+             * @description Unsigned content URL for the asset, ``baseUrl + contentPath``. It does not grant access by itself: the web app's read-prefix cookie authorizes it, and an API client appends ``?`` and a read prefix's ``signedQuery`` or uses ``assets/{asset}:createReadUrl`` instead. Null whenever ``contentPath`` is.
+             */
+            url?: string | null;
         };
         /**
          * AssetCreate
@@ -486,7 +491,7 @@ export interface components {
             operation: string;
             /**
              * Task
-             * @description The task that produced them, e.g. ``image2DraftSplats``.
+             * @description The task that produced them, e.g. ``atlasGenerate``.
              */
             task?: string | null;
             /** Assets */
@@ -636,9 +641,14 @@ export interface components {
             purgeContentOnOperationCompletion?: boolean | null;
             /**
              * Contextframes
-             * @description Posed depth frames, one per target camera and posed at it, in target order; each camera is 1280x720. Depth only: frames carry no imageAsset, maskAsset, or depth confidenceAsset. Leave empty to generate from the prompt alone.
+             * @description Posed depth frames, one per target camera and posed at it, in target order; each camera is 1280x720. Frames may also carry an imageAsset (the view's known pixels) and a maskAsset (8-bit grayscale, white where the frame's image and depth are known), each on every frame or on none: the model keeps the image where the mask is set and generates the rest, takes frames without masks as fully known, and conditions on the depth alone for frames without an image. Frames carry no depth confidenceAsset. Leave empty to generate from the prompt alone.
              */
             contextFrames?: components["schemas"]["PosedDepthAsset"][];
+            /**
+             * Sourceframes
+             * @description Posed RGB photographs of the scene, each an image and its camera in the targets' coordinate convention and scale. The generated views stay consistent with them: the servable feeds them to the model as views it has already committed, so a target that sees the same surfaces keeps their materials, colors, and lighting. Any cameras and any resolution; each is cover-resized and center-cropped onto 1280x720. Frames carry no maskAsset or depth. Together with contextFrames and targetCameras they fill at most 128 views of the servable's rollout, where a context frame costs 3 and a photograph or target one.
+             */
+            sourceFrames?: components["schemas"]["PosedRGBAsset"][];
             /**
              * Targetcameras
              * @description Pinhole cameras at 1280x720 for the views to generate, in output order, returned in `frames`. At most 32.
@@ -669,7 +679,7 @@ export interface components {
             modelParameters?: components["schemas"]["AtlasChiselModelParameters"];
             /**
              * Returndepth
-             * @description Return the generated frames as posed RGBD: they are reconstructed together so the depth lands in the request's own camera frame and scale, and every entry in `frames` then carries a `depth` buffer. The contextFrames' own depth is not reconstructed or returned. Needs at least two target cameras. Limitation: the depth scale is recovered from the target cameras' centres, so targets that share one centre (a pure-rotation rig) come back with a 0.0 or NaN scale and a success status.
+             * @description Return the generated frames as posed RGBD: they are reconstructed together so the depth lands in the request's own camera frame and scale, and every entry in `frames` then carries a `depth` buffer. The contextFrames' own depth is not reconstructed or returned. A source photograph joins the reconstruction as an anchor, and gets no depth back, only when its image is at the generated resolution and its camera's principal point is centered. Needs at least two target cameras. Limitation: the depth scale is recovered from the camera centers that joined, so targets that share one center (a pure-rotation rig) and no anchor come back with a 0.0 or NaN scale and a success status.
              * @default false
              */
             returnDepth?: boolean;
@@ -719,13 +729,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             done: boolean;
             /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description ``AtlasChiselResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["AtlasChiselResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -736,6 +744,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``AtlasChiselResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["AtlasChiselResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -778,9 +788,15 @@ export interface components {
              * @description Purge this operation's outputs and the transient uploads it consumed one hour after it finishes. Omitted, the account's setting applies; true raises it for this operation; false is refused when the account already purges. Uploads in the library are never purged by an operation.
              */
             purgeContentOnOperationCompletion?: boolean | null;
+            /**
+             * Base64Outputs
+             * @description When a ?wait=true submission is answered inline, return each output file as base64 in that response rather than by assetId and url. This skips storing the files before the answer and the caller's download after it. Any other submission, and every later read of the operation, names the outputs by assetId and url.
+             * @default false
+             */
+            base64Outputs?: boolean;
             /**
              * Contextframes
-             * @description Posed RGBD context views: each an image, its depth buffer, and its camera, all required. On the reference-context warp route the depth conditions the generation geometrically, so the generated views stay consistent with the provided scene; the hero base checkpoint conditions on the posed images only and does not consume the depth.
+             * @description Posed RGBD context views: each an image, its depth buffer, and its camera, all required. All context cameras must declare the same width and height. On the reference-context warp route the depth conditions the generation geometrically, so the generated views stay consistent with the provided scene; the hero base checkpoint conditions on the posed images only and does not consume the depth.
              */
             contextFrames: components["schemas"]["PosedRGBDAsset"][];
             /**
@@ -801,7 +817,7 @@ export interface components {
             enhancePrompt?: boolean;
             /**
              * Returndepth
-             * @description Return the generated frames as posed RGBD: they are reconstructed together with the context frames so the depth lands in the request's own camera frame and scale, and every entry in `frames` then carries a `depth` buffer. A context frame joins that reconstruction only when its image is at the generated resolution and its camera's principal point is centered. The scale is recovered from the camera centres that joined, so a request whose joined cameras all share one centre (a pure-rotation rig) is rejected.
+             * @description Return the generated frames as posed RGBD: they are reconstructed together with the context frames so the depth lands in the request's own camera frame and scale, and every entry in `frames` then carries a `depth` buffer. The scale is recovered from camera centres, so a request whose cameras all share one centre (a pure-rotation rig) is rejected. On the hero base route, with more than 19 context frames, or with a masked context frame, a context frame joins the reconstruction only when its image is at the generated resolution and its camera's principal point is centered.
              * @default false
              */
             returnDepth?: boolean;
@@ -853,13 +869,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             done: boolean;
             /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description ``AtlasGenerateResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["AtlasGenerateResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -870,6 +884,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``AtlasGenerateResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["AtlasGenerateResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -988,13 +1004,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             done: boolean;
             /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description ``AtlasMaskedResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["AtlasMaskedResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -1005,6 +1019,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``AtlasMaskedResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["AtlasMaskedResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -1113,13 +1129,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             done: boolean;
             /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description ``AtlasTextToImageResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["AtlasTextToImageResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -1130,6 +1144,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``AtlasTextToImageResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["AtlasTextToImageResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -1355,6 +1371,11 @@ export interface components {
              * @description Already percent-encoded path for the asset. Append it unchanged to ``baseUrl`` before ``?`` and ``signedQuery``. This path does not grant access by itself. Null until the asset is ``READY`` or when unavailable; use ``assets/{asset}:createReadUrl`` as a fallback.
              */
             contentPath?: string | null;
+            /**
+             * Url
+             * @description Unsigned content URL for the asset, ``baseUrl + contentPath``. It does not grant access by itself: the web app's read-prefix cookie authorizes it, and an API client appends ``?`` and a read prefix's ``signedQuery`` or uses ``assets/{asset}:createReadUrl`` instead. Null whenever ``contentPath`` is.
+             */
+            url?: string | null;
             /**
              * Uploads
              * @description One grant per declared part; empty for URL or inline ingestion.
@@ -1542,6 +1563,12 @@ export interface components {
              * @description Purge this operation's outputs and the transient uploads it consumed one hour after it finishes. Omitted, the account's setting applies; true raises it for this operation; false is refused when the account already purges. Uploads in the library are never purged by an operation.
              */
             purgeContentOnOperationCompletion?: boolean | null;
+            /**
+             * Base64Outputs
+             * @description When a ?wait=true submission is answered inline, return each output file as base64 in that response rather than by assetId and url. This skips storing the files before the answer and the caller's download after it. Any other submission, and every later read of the operation, names the outputs by assetId and url.
+             * @default false
+             */
+            base64Outputs?: boolean;
             /**
              * Frames
              * @description Ordered image inputs (min 1). A frame that carries a camera, a depth buffer or a mask is rejected rather than quietly ignored: none of them reaches the reconstruction.
@@ -1612,13 +1639,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             done: boolean;
             /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description ``Images2PosedRGBDResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["Images2PosedRGBDResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -1629,6 +1654,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``Images2PosedRGBDResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["Images2PosedRGBDResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -1678,7 +1705,7 @@ export interface components {
         };
         /**
          * ListedOperation
-         * @description An Operation as the Marble API lists it: with its callback's progress.
+         * @description An operation summary with callback progress; GET it for the result.
          */
         ListedOperation: {
             /**
@@ -1700,18 +1727,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             done: boolean;
             /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /**
-             * Response
-             * @description Task-specific result when ``done`` is true and the task succeeded; null while running and after failure.
-             */
-            response?: {
-                [key: string]: unknown;
-            } | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -1772,7 +1792,7 @@ export interface components {
         };
         /**
          * Operation
-         * @description The common envelope used to track an asynchronous task.
+         * @description An operation with its result, available through singular reads.
          */
         Operation: {
             /**
@@ -1794,18 +1814,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             done: boolean;
             /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /**
-             * Response
-             * @description Task-specific result when ``done`` is true and the task succeeded; null while running and after failure.
-             */
-            response?: {
-                [key: string]: unknown;
-            } | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -1816,6 +1829,13 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /**
+             * Response
+             * @description Task-specific result when ``done`` is true and the task succeeded; null while running and after failure.
+             */
+            response?: {
+                [key: string]: unknown;
+            } | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -2015,7 +2035,7 @@ export interface components {
             session?: string | null;
             /**
              * Task
-             * @description The task that produced it, e.g. ``image2DraftSplats``.
+             * @description The task that produced it, e.g. ``atlasGenerate``.
              */
             task?: string | null;
             /**
@@ -2043,8 +2063,8 @@ export interface components {
             renderHw?: number;
             /**
              * Renderhwsecondary
-             * @description Height and width of the secondary views, in pixels. The anchor strategies sample extra cameras around each anchor and render them here, covering what the main views miss. `exterior_sphere` and a supplied camera list render no secondary views and ignore this.
-             * @default 640
+             * @description Height and width of the secondary views, in pixels. The anchor strategies place extra cameras from the anchors and render them here, covering what the main views miss. `exterior_sphere` and a supplied camera list render no secondary views and ignore this.
+             * @default 256
              */
             renderHwSecondary?: number;
             /**
@@ -2054,6 +2074,13 @@ export interface components {
              * @enum {string}
              */
             normalSource?: "depth" | "render";
+            /**
+             * Depthsource
+             * @description Depth of the main views. `render` uses the splats' rendered depth; `stereo` measures it by stereo matching each view against a second render from a camera shifted sideways, which is sharper where the splats are fuzzy and slower to compute. Pixels stereo cannot match keep the rendered depth.
+             * @default render
+             * @enum {string}
+             */
+            depthSource?: "render" | "stereo";
             /**
              * Resolution
              * @description Resolution of the grid the implicit surface is built on, across the region's longest side. Powers of two only. This sets the finest detail the mesh can carry.
@@ -2195,13 +2222,11 @@ export interface components {
             } | null;
             /**
              * Done
-             * @description Whether the operation is terminal. When false, both ``response`` and ``error`` are null.
+             * @description Whether the operation is terminal. When true, a non-null ``error`` indicates failure; otherwise the operation succeeded.
              */
             done: boolean;
             /** @description Failure details when ``done`` is true and the task failed; null while running and after success. */
             error?: components["schemas"]["OperationError"] | null;
-            /** @description ``Splats2MeshResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
-            response?: components["schemas"]["Splats2MeshResponse"] | null;
             /**
              * Expiresatsecs
              * @description Task execution deadline as Unix seconds, when one is exposed. This is not an asset URL expiration.
@@ -2212,6 +2237,8 @@ export interface components {
              * @description Unix seconds when the operation was accepted.
              */
             createdAtSecs?: number | null;
+            /** @description ``Splats2MeshResponse`` result when ``done`` is true and the task succeeded; null while running and after failure. */
+            response?: components["schemas"]["Splats2MeshResponse"] | null;
             /**
              * Name
              * @description Full resource name for the operation.
@@ -2229,7 +2256,9 @@ export interface components {
          *     A task response names each output by id and url together: the url expires,
          *     the id does not. The pair is accepted as input as well, so a response can
          *     be handed straight back to the next task; the id names the media and the
-         *     url is ignored. Inline base64 is an input form only, and stands alone.
+         *     url is ignored. Inline base64 stands alone. A response returns it only
+         *     when a task is answered at submission; the stored operation names the
+         *     same output by id and url.
          */
         TaskAsset: {
             /**
@@ -2239,7 +2268,7 @@ export interface components {
             assetId?: string | null;
             /**
              * Base64
-             * @description Base64-encoded media bytes, with or without a data URL prefix. Decoded size must be less than 10 MiB. Input only: a task response never carries inline bytes.
+             * @description Base64-encoded media bytes, with or without a data URL prefix. Decoded size must be less than 10 MiB. A task response carries inline bytes only when it is returned from the submission; the stored operation names the same output by `assetId` and `url`.
              */
             base64?: string | null;
             /**
@@ -2974,7 +3003,7 @@ export interface operations {
                 mimeType?: string | null;
                 /** @description Only assets this Operation produced. */
                 operation?: string | null;
-                /** @description Only assets this task produced, e.g. `image2DraftSplats`. */
+                /** @description Only assets this task produced, e.g. `atlasGenerate`. */
                 task?: string | null;
                 /** @description Only assets made this way, e.g. `UPLOAD` for the customer's own bytes. Assets recorded before the producer was stored match no value. */
                 producer?: components["schemas"]["AssetProducer"] | null;

package/src/index.ts

@@ -13,6 +13,7 @@ export {
   type DoneOperation,
   type Fetch,
   type Middleware,
+  NetworkError,
   type Operation,
   type ListAssetsOptions,
   type SubmitOptions,